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About This Manual 


PURPOSE OF THIS MANUAL 

This manual is written for programmers who use IBM 
System/38. 

This manual contains detailed instructions for coding the 
data description specifications (or DDS) for files that can 
be described externally. These files are the physical, 
logical, display, printer, communications files, and BSC 
files. Although Chapter 1 does review the process of 
creating such files, and Appendix F does provide 
examples of each type of file discussed in this manual, 
you should not read or attempt to use this manual 
without knowing how you intend to use externally 
described files in your application. 

For an understanding of the context in which DDS is 
used, see the CPF Concepts Manual and the CPF 
Programmer’s Guide. (The full titles and order numbers 
of these manuals appear at the end of this section.) 

For detailed descriptions of the specific commands used 
to create and delete files or to change and override their 
attributes, seethe CPF Reference Manual-CL 

If your application involves data communications with 
another system, see the Data Communications 
Programmer’s Guide before using Chapter 6, 
Communications Files. 

If you are using program-described files, see the CPF 
Programmer’s Guide and the appropriate high-level 
language manual. 


ORGANIZATION OF THIS MANUAL 

See the Summary of Changes later in this section for the 
most recent changes to this manual. 

Chapter 1 contains an overview of DDS, describing: 

• The function of DDS 

• How you use DDS 

• Types of files (that is, data base and device files) 

• Three steps to creating an externally described file 

- Filling in the Data Description Specifications form 

- Entering DDS source statements 

- Creating files 

• Describing files level by level 

• Syntax coding examples 

• DDS syntax rules 

Chapters 2 through 6 discuss both positional entries and 
keyword entries for each type of file: 

• Data base files 

- Physical files (Chapter 2) 

- Logical files (Chapter 3) 

• Device files 

- Display files (Chapter 4) 

- Printer files (Chapter 5) 

- Communications files and BSC files (Chapter 6) 

In the Keyword Entries sections of Chapter 4, Display 
Files and Chapter 6, Communications Files, sections 
called Use of Routing Keywords precede the first routing 
keyword (RTGAID). These sections explain some of the 
interrelationships among routing keywords. 

The appendixes in this manual contain information on 
how to specify the REF and REFFLD keywords, keyword 
summaries for the various types of files, sample files, 
and a list of abbreviations used in DDS. 

The Glossary follows the appendixes. 
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This manual uses the following conventions: 

• He means he or she. 

• In the keyword descriptions, this field or this record 
format means the field you are now defining or the 
record format you are now defining. 

• The expression use this file or record level keyword 
means the keyword is valid only at the file or record 
level. 

• To specify a keyword means to code the keyword in 
the DDS for a file. This contrasts with to select a 
keyword or when a keyword is in effect, which both 
mean that any conditioning (such as one or more 
option indicators) is satisfied when an application 
program issues an output or input operation (write or 
read operations). 

• The mention of one option indicator in the keyword 
descriptions indicates that any valid number or 
combination of indicators can be specified. 

• Current source or source you are defining means the 
DDS that together make up the description of one 
file. 

• In sample displays, character fields are shown as all 
Xs and numeric fields are shown as all Ns. 


• New keywords and new keyword spellings for 
compatibility with other systems as follows: 

- New CHECK codes providing the same function as 
AUTO and LOWER 

- CMP also spelled as COMP 

- SETOF also spelled as SETOFF 

“ Alternative parameter values can now be specified 
for DSPSIZ 

• Extensive rewriting of the manual, with many new 
explanations and examples, including the following: 

“ Complete rewriting of the field reference function 
“ Complete rewriting of FORMAT and UNIQUE In 

data base files 

- Complete rewriting of Key Field Names in Chapter 
3 

- Thorough revision of Data Type/Keyboard Shift in 
Chapter 4 

- Elimination of Use of Subfile Keywords; information 
now in the CPF Programmer's Guide and in the 
SFL and SFLCTL keyword descriptions 

- Complete rewriting of many keywords in 
Chapter 4, including all the subfile keywords 

~ Thorough revision of communications file 
keywords and addition of BSC Information 
“ New Combined Chart for handy reference to 
display file keywords in Appendix C 
~ New subfile examples in Appendix F 

• Miscellaneous technical changes indicated by a 
vertical line to the left of the change or addition 


SUMMARY OF CHANGES 

WHAT YOU SHOULD KNOW 

The major changes to this publication include: 

To use this manual effectively, you should know how to: 

• New display file keywords as follows: 

- CLRL (clear line) 

- CSRLOC (cursor location) 

- OVRATR (override attribute) 

- OVRDTA (override data) 

- PUTOVR (put override) 

“ RTNDTA (return data) 

- SLNO (starting line number) 

• New optional parameter values for the following 
keywords: 

- ERASEINP 

- MDTOFF 
~ UNLOCK 


Use SEU or data-entry system to enter DDS source 

Enter the create file commands on System/38 (such 
as Create Physical File [CRTPF] or Create Display 
File [CRTDSPF]) 

Use a high-level language (RPG III, COBOL, or CL) to 
develop an application program 
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IF YOU NEED MORE INFORMATION 

To correct a problem, you may need to refer to another 

IBM publication for a specific type of information: 

CPF (Control Program Facility) Commands and 

Functions 

• IBM System/38 Control Program Facility Concepts 

Manual, GC21-7729 

- Describes the concepts involved In data base 
design and application development 

• IBM System/38 Control Program Facility 

Programmer’s Guide, SC21-7730 

- Describes, and contains examples of, using DDS 
to describe data base and device files 

- Describes the processing of data base files 

- Describes physical and logical file members 

- Describes using display files in a program 

- Describes the I/O requests that can be made to a 
display file 

- Describes the device-dependent attributes of card, 
diskette, tape, and printer files, and describes how 
to use the files 

- Contains a description of the data management 
feedback area 

— Describes creating and changing source files 

- Describes copying to and from source files 

- Describes using an inline data file 

- Describes processing considerations for inline data 
files and spooled output files 

- Describes how to create a message file and 
user-defined messages 


• IBM System/38 Control Language Reference Manual, 

SC21-7731 

- Describes control language syntax 

~ Describes control language commands and 
parameters 

- Lists command authorizations by user profile 

• IBM System/38 Programmer’s/User’s Work Station 

Guide, SC21-7744 

- Describes how to enter commands, using the 
command entry display and the prompting facilities 
provided by CPF 

- Describes how to communicate with System/38 
through an interactive work station, especially 
when using the functions available through the 
Control Program Facility (CPF) 

• IBM System/38 Application Example I, SC21-7881 

- Describes how to use spooling for input of source 
statements 

- Describes how to create programs from diskette 
input (the same process is used to create files 
from diskette input) 

— Describes how to use the source entry utility (SEU) 
to enter source for files and programs 

- Describes how to use the programmer menu to 
create files and programs 

— Describes how to create and execute a data file 
utility (DFU) application 

- Describes how to create a menu from a separate 
display file and control language program 

- Describes how to create a menu using the screen 
design aid (SDA) 

- Describes how to use a logical file to create a 
different access path 
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Languages 


Utilities 


This list includes the publications referred to as 

appropriate high-level language manual in this manual: 

• IBM System/38 Introduction to RPG III: External Data 

Description and Interactive Processing, GC21-7723 

“ Describes how to code an interactive RPG 
program that prints a report 

- Describes how to code an interactive RPG 
program that inquires into an externally described 
file 

- Describes how to enter, compile, and run the 
program 

• IBM System/38 RPG III Reference Manual and 

Programmer's Guide, SC21-7725 

- Describes how to code RPG III programs 
Describes how to compile and run RPG III 
programs 

- Describes how to test and debug RPG III 
programs 

- Describes how to interpret compiler listings and 
messages 

- Describes how to perform problem determination 
procedures 

• IBM System/38 Concepts for the COBOL User, 

GC21-7855 

“ Contains conceptual information on the System/38 
data base and work station environment 

- Relates COBOL language functions to system 
functions 

• IBM System/38 COBOL Reference Manual and 

Programmer's Guide, SC21-7718 

- Describes how to code COBOL programs 

- Describes how to interpret COBOL compiler 
listings and messages 

- Describes how to test and debug COBOL 
programs 

- Describes how to perform problem determination 
procedures 

• IBM System/38 Control Program Facility 

Programmer's Guide, SC21-7730 

- Describes, and contains examples of, control 
language programs 

- Describes how to use variables, display files, and 
messages in control language programs 

- Describes how to monitor for messages in control 
language programs 


• IBM System/38 Screen Design Aid Reference Manual 
and User's Guide, SC21-7755 

- Describes how to design, create, maintain, and 
test display files interactively (using SDA) 

• IBM System/38 Source Entry Utility Reference Manual 
and User's Guide, SC21-7722 

- Describes how to enter and maintain DDS source 
statements using SEU 

- Describes how to browse through a spooled file to 
see compiler output, scan for errors, and correct 
source statements that contain errors 

• IBM System/38 Data File Utility Reference Manual 
and User's Guide, SC21-7714 

- Describes how to enter data records into a 
physical file using DFU 

- Describes how to change or delete data records in 
a physical file using DFU 

Messages 

• IBM System/38 Messages Guide: CPF, RPG III, and 
IDU, SC21-7736 

- Contains an overview of messages and the 
circumstances under which they may appear 

- Describes the elements of messages 

- Contains a problem determination section, which 
includes additional information about the problem 
for which the message was issued 

- Contains all messages other than COBOL 
messages 

• IBM System/38 Messages Guide: COBOL, SC21-7823 
“ Contains a detailed description of message 

structure and the meaning of each message 
element 

- Explains how to add user-defined messages to the 
system 

- Lists all COBOL messages with additional 
information that is not displayed or printed by the 
system 
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Coding and Debugging Material 


• IBM Data Description Specifications, GX21-7754 

- To code (specify) DDS 

• IBM Data Description Specifications (DDS) Debugging 
Template, GX21-7717 

- To interpret fields on the DDS source listings 


Communications 

• IBM System/38 Data Communication Programmer's 

Guide, SC21-7825 

- Describes the use of data description 
specifications (DDS) for communications; also, 
describes the Create Communications File 
(CRTCMNF) and Create BSC File (CRTBSCF) 
commands 

- Identifies communications programming 
considerations and contains examples of RPG III 
and COBOL programs for communications with 
BSC and SNA devices and systems 

— Describes error handling for communications 

- Identifies the device-dependent considerations for 
supported SNA hosts, and BSC devices and 
systems 


Device Operation 

• IBM System/38 Programmer's/User's Work Station 
Guide, SC21 -7744 

- Describes the keys on the 5250 work station 
keyboards (typewriter-like and data-entry) 

- Describes the keys on the system console 
keyboard 


Content and Use of System/38 Publications 

• IBM System/38 Guide to Publications, GC21-7726 

- Describes contents of System/38 manuals 

- Describes reading sequences for System/38 
manuals 

• IBM System/38 Glossary and Master Index, 
GC21-7727 

- Defines terms used in System/38 manuals 

- Combines entries from indexes of System/38 
manuals used frequently 




Chapter 1. Introduction 


THE FUNCTION OF DATA DESCRIPTION SPECIFICATIONS 

A traditional means of describing data attributes (such as the names and 
lengths of records and fields) is to specify the data attributes in the application 
programs themselves. In RPG this is done in the input or output specifications, 
and in COBOL this is done in the Data Division. On System/38 this method of 
data description is called program-described data; however, a convenient and 
powerful alternative is available. Through the use of data description 
specifications (DDS), the programmer can describe data attributes externally; 
that is, not in the application programs themselves but in file descriptions 
independent of the programs. These file descriptions are associated with the 
files themselves. The files for which DDS can be used are: 

• Physical files (DDS is optional) 

• Logical files (DDS is required) 

• Display files (DDS is recommended) 

• Printer files (DDS Is optional) 

X • Communications files and BSC files (DDS Is required) 

For card files, diskette files, and tape files, program-described data must be 
used. 

The CPF Reference Manual—DDS is a reference manual for programmers using 
externally described files. For information about the co ntext within which to 
use DDS, and for a description of program-described files, see the CPF 
Programmer's Guide and the appropriate high-level language manual. 
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CPF SUPPORT FOR DATA DESCRIPTION SPECIFICATIONS 


The Control Program Facility (CPF), through data base data management and 
device data management, provides support for DOS at three points: 


• When you cre jte a file (with a create file command such as CRTLF and 
CRTDSPF). In this manual, this is called file creation time. 

• When you compile an application program (with a create program command 
such as CRTJRESpGM and CRTCBLPGM). In this manual, this is called 
program compilation time. 

• When your program issues a request to a file. In this manual, this is called 
execution tfmC Exec^ time Includes the following: 

- When the file is opened or closed. 

- When your program issues an I/O operation to the file, specifically: 

a. Write or Put operations (in this manual, output operations) 

b. Read or Get operations (in this manual, input operations) 

c. Update operations 

At file creation time for externally described files, CPF performs a function 
much like the compilation of application programs, invoking the data 
description processor, reading the DDS source, printing any diagnostic 
messages, and creating a CPF object (type *FILE). Further, CPF provides a 
reference function whereby record formats or field descriptions can be 
duplicated from an already existing file into the new file. CPF also establishes 
access paths as required. 

At program compilation time, the language compiler brings data descriptions 
from externally described files into the executable program and lists the data 
descriptions on the compiler listing. 

At execution time, CPF processes data passing between the application 
program and the data base or device. 

See Figure 1-1 for an illustration of file access through DDS. 



Device 


Figure 1-1. File Access at Execution Time 




TYPES OF FILES 


Two types of files are used to pass data between the System/38 and 
application programs: 

• Data base files include physical files (which can actually contain data 
records) an d logical fil ej^jwhich can contain only record formats, not data 
records, and which provide logical views of the data records stored in 
physical file s). 

• Device files include display fil es, printer f i le^ communications files, and BSC 
(Binary Synchronous Communications) files. These types of file can be 
described using DPS . (Other types of device file, such as diskette, card, 
and tape files, cannot be described using DPS.) As illustrated in Figure 1-1, 
device files describe devices to the system so that device data management 
can pass data between your programs and the devices. 


Data Base Files 

Pata base files describe how your data is stored and how it is presented to 
your programs. There are two types of data base files: 

• Phys/ca/ f//es: The PPS for a physical file describes how your data records 

are actually stored in the data base. Fi e ld s within the record forma t of a 
p hysic al,file determine the attributes of the fields In the data base. The 
presence of a key field in keyed sequence in the data base; when no 

key field is specified, arrival sequence is used in the data base. 

• Logical files: The PPS for a logical file describes how data re cords appear 

to be stored in the data base; however, the logical file does not actually 
contain da^ A logical file is always based on one pr more physical 

files. The logical file determines how data records are sequenced and 
transformed when read by an application program from the physical file(s) 
and how data records are transformed and sequenced when written from an 
application program to the physical file(s). 

Figure 1-2 illustrates the relationship between two logical files (logical file A 
and logical file B) and a common physical file. Program A and program B see 
only the logical views of the data records as these views are presented by the 
logical files A and B. The PPS for the physical file describes how the data 
records are actually stored in the data base. 

Figure 1 -3 illustrates the relationship between one logical file and two physical 
files on which it is based. The program can access data in the two physical 
files through a record format In the logical file. Even if the physical files have 
different record formats or different sequences of records, to the program they 
are the same. 
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Program A 


Program B 


How Data 
Records 
Appear to 
Program A 



How Data 
Records 
Are Actually 
Stored 


Figure 1-2. Two Logical Files Based on One Physical File 


Program 



Records 

Are Actually 

Stored Stored 


Figure 1-3. One Logical File Based on Two Physical Files 




Coding Characteristics of Data Base Files 


Physical files m ust ha ve only one record form at. 

Logical files can have more than one record format, and each record format 
must have the PFILE keyword specified for it. 


Field Reference Files 

A field reference file is a physical file that defines all fields needed for an 
application or a group of relatedThe field reference file contains no data 
and should be created without a member (MBR(*NON E) specified for the 
Create Physical File (CRTPF) command). Like all physical files, a field reference 
file has only one record format. As needed, you can define up to 8000 fields 
on the field reference file to form a standardized list of named files to be 
referenced by other files. 

To reference fields in a field reference file, use the reference function provided 
by DOS. To use the reference function in a file you are defining, you specify R 
in position 29 for each field that references another field (see Position 29 
(Reference) in the appropriate chapter for details) and the name field 
reference file as a parameter value on the REF or REFFLD keyword. 


Certain field attributes, suc h as location, are required in device files but are 
Invalid in data base files. When you reference a field reference file from a 
device file, you must specify the field attributes required by the device file. If 
you specify a field attribute that is already defined in the field reference file, 
you override the referenced attribute. Some such overrides affect other 
attributes; see Position 29 (Reference) for the effect overriding certain 
attributes has on others. 


Access Paths 

Each member of a data base file has an access path. The access path allows 
data management to sequence the records In the member. There are two 
types of access paths: arrival sequence and keyed sequence. 

• Arrival sequence access path: Data management sequences the records of a 
member either sequentially or by relative record number. No key fields are 
specified in the DDS. 

• Keyed sequence access path: Data management sequences the records of a 
member according to the contents of the key fields of the records. If you 
want keyed access to the records, you must specify key field Information 
when you specify the DDS for the file. (See the sections on Key Field 
Name in Chapters 2 and 3 in this manual.) 

Figure 1 -4 shows how arrival sequence and keyed sequence access paths 
function. For a discussion of the considerations for access paths and data 
base file members, see the CPF Programmer's Guide. 
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Program A sees data 
records in this order 


Program B sees data 
records in this order 


Program C sees data 
records in this order 


Board man 
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Johnson 
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Figure 1-4. Ascending Keyed Sequence, Descending Keyed Sequence, and Arrival Sequence Access Paths. 

Logical files A and B, with keys specified (key field specifications), determine the order of 
records written to or read from the physical file. Logical file C, with no key specified, does 
not. 











Device Files 


Device files describe how data is processed through input/outpi^ 
attached to System/38, such as display devices, printers, and diskettes. Each 
device used by a program has a device file, which is an executable CPF object 
created through the use of a create file command. Some of these device files 
(those used for display devices, printers, and communications or BSC devices) 
can use DDS to define file, record, and field characteristics. When they do so, 
they are called externally described files because the data Is described outside 
of the programs that use the devices. Other device files (those used for cards, 
tapes, and diskettes) cannot use DDS and must be program-described device 
files. For these devices, field-level characteristics must be described in the 
program itself. (Note that you can have a program-described file that is 
externally described using DDS. See the appropriate high-level language 
manual for information on how to do this.) 
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The following diagrams illustrates the difference between using DDS when 
creating externally described files and not using DDS when creating 
program-described files: 




Note: Display and printer files can also be program-described. 







Coding Characteristics of Device Fites 


Devic e files permit more than one record forma t. 

Dev ice files permit the use of option injdicators. 

JDi splay files and printer files require the location^ of fields (except for special 
cases); communications files and BSC files do not allow them. 

Display files, communications files, and BSC files have specifications related to 
both [nput and output as follows: 

• In display files, you can define a fiel^as mput only, output only, 
output/input, message, or hidden. 

• In disj)lay files, communications files, and BSC files, indicators can be used 
for output (option indicators) or input (response indicators). 


THREE STEPS TO CREATING AN EXTERNALLY DESCRIBED FILE 

The three general steps to creating a file are: 

1. Fill in the Data Description Specifications form. 


2. Enter the DDS source statements into a source file. The source file can 
be part of the System/38 data base (in a source physical file such as the 
IBM-supplied QDDSSRC) or it can be on cards or diskette. 

3. Create the file using the appropriate create file command. 

This manual is concerned primarily with step 1; however, an overview of all 
three steps is provided in the following sections. 

Note: Through the SDA utility, display file s can be created and tested without 
coding DDS directly. See the SDA Reference Manual and User's Guide. 

After a physical file has been created, records can be entered into it and 
grouped by members. This can be done through the use of the data file utility 
(DFU), which is part of the Interactive Data Base Utilities (IDU) Licensed 
Program, program 5714-UT1. This utility is described in the IBM System/38 
DFU Reference Manual and User's Guide, SC21-7714. If you do not have this 
utility, you can write a high-level language program for data entry. 
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Filling In the Data Description Specifications Form 


A sample Data Description Specifications form is printed in reduced size in 
Figure 1-5. 

The left side of the Data Description Specifications form (positions 1 through 
44) is for fixed-format entries called positional entries. Positional entries define 
the most common attributes of record formats and fields, such as names and 
lengths of fields. For a brief description of the most important positional 
entries, see items 1 through 7 following; for details, see the sections on 
Positional Entries in Chapters 2 through 6. 

The right side of the Data Description Specifications form (positions 45 through 
80) is for DDS keywords. DDS keywords define less-common and 
more-varied attributes of files, record formats, and fields; they follow a subset 
of the syntax rules for control language. For a brief description of keywords, 
see item 8 following; for details, see the sections on Keyword Entries in 
Chapters 2 through 6. 


Positional Entries 

Q Sequence Number and Form Type are optional in DDS. Form Type 

identifies the source as DDS source. The entries are valid for all types of 
files. 

Q An asterisk in position 7 makes the entire line a comment (for ail types of 
files). When A (And), 0 (Or), or blank is in position 7, positions 8 
through 16 can provide conditioning for the DDS on or immediately 
following the current line (conditioning is not valid in physical or logical 
files). 

Q Name Type (position 17) identifies the Name entry (positions 19 through 
28) as a record format name (for all types of files), a field name (for all 
types of files), a key field name (for physical and logical files only), or a 
select/omit field (for logical files only). 

Q An R specified in position 29 indicates that attributes of the field named 
in Name are to be referenced from a field specified elsewhere (ignored 
for logical files). 

Q Length, Data Type, and Decimal Positions specify attributes of named 
fields within record formats (valid for all types of files). 

Q Usage specifies fields as input, output, output/Input, hidden, or message 
fields for device files. Each type of device file has its own restrictions 
regarding field usage. 

Q Location specifies the location of the field on the display screen or on the 
printed page (for display and printer files only). 


Keyword Entries 

Q Functions specified through the use of keywords apply at the file, record, 
or field level (for all types of files), or at the key field level (for physical 
and logical files only), or at the select/omit field level (for logical files 
only). Also, constants specified within apostrophes become the default 
values for displayed or printed fields (for display and printer files only; 
see the DFT keyword descriptions in the respective files). 
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Figure 1-5. Overview of the Positional and Keyword Entries on the Data Description Specifications Form 
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Entering Data Description Specifications Source Statements 


After filling out the Data Description Specifications forms, you must enter the 
source into source files. You can enter the source interactively or in batch. 


Interactively (Using SEU) 

You can use the source entry utility (SEU) of the Interactive Data Base Utilities 
Licensed Program (IDU): 



Enter the Edit Source (EDTSRC) command to call SEU. (See the Source Entry 
Utility Reference Manual and User's Guide for further information on using SEU 
to enter or update DDS source.) 



Sample SEU Display: The following shows how DDS source statements, 
specified on the Data Description Specifications form, would appear when 
being entered through SEU. Line 45 is about to be entered. Notice how the 
option indicator at Q and the functions (keywords) field at Q appear on the 
SEU display. 
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In Batch (Using Cards or Diskette) 


You can use one of the following methods: 

• Enter an input stream containing DDS source and CL commands on cards or 
diskette and start a spooling reader (STRCRDRDR or STRDKTRDR 
command): 


Diskette 



Cards 


• Enter only source statements on cards or diskette and copy the resulting 
data file into a source physical file (CPYF command): 


Diskette 



Cards 


• Enter only source statements on cards or diskette and enter a create file 
command (specify the name of the data file on the SRCFILE parameter and 
*FILE on the SRCMBR parameter of the create file command): 


Diskette 



Cards 


Note: When using this method, no source physical file is created. 
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Creating Files 


You create files on System/38 by issuing a create file command. The 
particular create file command to use depends on the type of file you are 
creating: 


Physical file 
Logical file 
Display file 
Printer file 

Communications file 
BSC file 


CBTPF^ 

CRIIJ;) 

CRTDSPF? 

CRTPirn^ 

CRTCMNF 

CRTBSCF 


Parameter values on the commands identify some of the attributes of the file, 
such as the file name, whether the file can be shared, and authority for the file. 
For card, tape, and diskette files, DDS is not valid. 

A create file command invokes the data description processor for externally 
described files. You can enter the create file command from a work station 
either interactively or in batch. (See the Programmer's/User's Work Station 
Guide.) The data description processor retrieves the DDS from the source file 
designated on the create file command, validates the specifications, and 
creates a data base or device file and a DDS source listing (also called a 
compiler listing): 



The DDS source listing is a printout of the file's data description; any error 
condition that relates to the data description specifications is identified in this 
listing. If there are no serious errors in the DDS, the file is created. Appendix 
F shows a sample DDS source listing and a reduced copy of the Data 
Description Specifications Debugging Template (used to interpret fields on the 
DDS source listing). 
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HOW TO DESCRIBE FILES 


Describing Files Level by Level 

When you use data description specifications, you specify the following items, 
as illustrated in Figures 1-6 through 1-10: 

• File level keywords 

• Record format names and record level keywords 

• Field names, field attributes, and field level keywords 

• Key field names and key field level keywords (physical and logical files only) 

• Select/omit field names and select/omit level keywords (logical files only) 
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•Number of iheets per pad may vary glightly. 


Q Comments (optional): Comments can appear on any line in DDS. They are identified by an asterisk in position 7. 

0 File level (optional): File level keywords appear before the record format name (RECORD on line 00040). 

0 Record level (only one allowed in physical files): The R In position 17 identifies RECORD as a record format 
name. The record level continues until the first field is named. 

0 Field level (at least one field name required): For fields in physical files, at least a name and length must be 
specified. Other attributes can be specified explicitly or by default. 

0 Key field level (optional): The key field level Is specified by repeating a field name (here, FIELDA) after the field 
level specifications. The K specified in position 17 is required at the key field level. 

Figure 1-6. Syntax for a Physical File 
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Q Comments (optional): Comments can appear on any line in DDS. They are identified by an asterisk in position 7. 

Q File level (optional): File level keywords appear before the first record format name (RECORD1 on line 00040). 

Q Record level (at least one required): The R in position 17 identifies RECORD1 as a record format name. In 

logical files, the PFILE keyword is required for every record format. The record level continues until the first field 
is named. 

Q Field level: Field names and field attributes are not required for logical files. See Chapter 3, Logical Files, for a 
description of the various ways to specify a logical file record format. 

Q Key field level (optional): The key field level is specified by repeating one or more field names (such as FIELDA) 

after the field level specifications. The K specified in position 17 is required at the key field level. 

Q Select/omit level (optional): The S in position 17 identifies FIELDS as a select/omit field (an O could also be 
specified in position 17 at the select/omit level). The select/omit level follows the key field level. 

Note: Items Q through Q can be repeated to specify new record formats within the logical file. 

Figure 1-7. Syntax for a Logical File 
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You can specify option indicators and screen 
size condition names in the boxed-in positions. 


Q Comments (optional): Comments can appear on any line in DDS. They are identified by an asterisk in position 7. 

^ File level (optional): File level keywords appear before the first record format name (RECORDA on line 00040). 

Q Record level (at least one required): The R position 17 identifies RECORDA as a record format name. The record 
level continues until the first field is specified. 

0 Field level (optional): Display file fields that are to be passed between the display device and your program must 
be named fields and must have a length specified. Other attributes can be specified explicitly or by default. 
Constant (unnamed) fields require only a location and a keyword, as described in the DATE, DFT, and TIME 
keyword descriptions in Chapter 4. Positions 17 through 38 do not apply to constant fields. 

Note: Items Q through Q can be repeated to specify new record formats within the display file. 

Figure 1-8. Syntax for a Display File 
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You can specify option indicators 
in the boxed-in positions. 


Q Comments (optional): Comments can appear on any line in DDS. They are identified by an asterisk in position 7. 

^ File level (optional): File level keywords appear before the first record format name (RECORDA on line 00040). 

Q Record level (at least one required): The R position 17 identifies RECORDA as a record format name. The record 
level continues until the first field is specified. 

Q Field level (at least one field, whether named or unnamed, is required in each record format in the file): Printer 
file fields that are to be passed from your program to the printer must be named fields and must have a length 
specified. Other attributes can be specified explicitly or by default. Constant (unnamed) fields require only a 
location and a keyword, as described in the DATE, DFT, PAGNBR, and TIME keyword descriptions in Chapter 5. 
Positions 17 through 38 do not apply to constant fields. 

Note: Items Q through 0 can be repeated to specify new record formats within the printer file. 


Figure 1-9. Syntax for a Printer File 
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You can specify option indicators 
in the boxed-in positions. 

Q Comments (optional): Comments can appear on any line in DDS. They are identified by an asterisk in position 7. 

Q File level (optional): File level keywords appear before the first record format name (RECORDA on line 00040). 

Q Record level (at least one required): The R position 17 identifies RECORDA as a record format name. The record 
level continues until the first field is specified. 

0 Field level (at least one field, whether named or unnamed, is required for at least one record format in the file): 
Communications and BSC file fields must have at least a name (as in FIELDA) and a length. Other attributes can 
be specified explicitly or by default. 

Note: Items 0 through 0 can be repeated to specify new record formats within the communications or BSC file. 
Figure 1-10. Syntax for a Communications File or a BSC File 
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DATA DESCRIPTION SPECIFICATIONS SYNTAX RULES 


The syntax for coding DDS keywords and their parameter values is a 
compatible subset of the syntax used for the control language. Figures 1 -6 
through 1-10 show how to use this syntax for each type of file. The general 
rules are: 

• Code all DDS entries in all uppercase except for character literals. 

• Code keywords on the same line as the entry with which they are associated, 
or on subsequent lines. 

• Separate multiple keywords with one or more blanks. Parameter values for 
keywords must be enclosed in parentheses with the initial parenthesis 
immediately following the keyword, for example, 

KEYWORD(VALUE) 

(This rule differs slightly from control language because, when coding 
control language, parameter values can be positional. Syntax for data 
description specifications requires that the keyword be specified, except 
when specifying a constant or the parameter value for the DFT keyword.) 

• Separate multiple parameter values for the same keyword with one or more 
blanks. For example, 

KEYWORD(VALUEA VALUER) 

• Use a period to separate the components of a qualified name. Embedded 
blanks are not allowed. For example, 

KEYWORD(file.library) 

• Use apostrophes to enclose character literals. (Numeric literals appear 
without apostrophes; see the coding examples for the COMP, RANGE, and 
VALUES keywords.) Character literals can appear in two places in the 
syntax for DDS: 

- As a parameter value for some keywords. For example, TEXT (In all 
types of files) and COLHDG (in data base files) require character literals 
as text description. Other keywords such as CAnn and CFnn use 
character literals as text descriptions for response indicators. 

- With or without the DFT keyword, for display and printer files only, as 
the default value of a constant field. In printer files a character literal can 
also be specified for named fields. Even if you do not specify the DFT 
keyword, specifying a character literal implies the DFT keyword. 



Use double apostrophes (") when specifying any apostrophes within a 
quoted parameter value so that one apostrophe will appear in output. For 
example, 

KEYWORDrCustomer"s name') 
appears as 

Customer's name 

Use a plus (+) or minus (-) sign to indicate that a keyword and its parameter 
values are continued on the succeeding line. The sign (+ or -) that you 
choose for a continuation character has a particular meaning as follows: 

- A minus (-) sign indicates that the continuation is to begin in position 45 
of the next line (the first position of the functions field). 

- A plus (+) sign indicates that the continuation is to begin with the first 
nonblank (first significant) character in the functions field on the next line. 

If you specify a continuation character within a parameter value (such as a 
character literal), any blanks preceding the continuation character are 
included in the parameter value. 

The sign must be the last nonblank character in the functions field. One of 
the signs must be used when the entire specification for a keyword does 
not fit on a single line. A single statement can be continued to a maximum 
of 2000 character positions. 

Specify a plus (+) sign as the last nonblank character on a line to continue 
conditioning for keywords specified on the next line. This is especially 
helpful when a condition includes several option indicators and applies to 
several keywords. 

CPF implicitly continues a DOS statement until you specify one of the 
following: 

- A record format name (R in position 17) 

- A field specification (field name or location) 

- For device files, an option indicator or condition name that conditions a 
field or a field location 

The keyword descriptions use the following punctuation marks: 

[ ] Enclosed values are optional. 

[...] Specify additional values as needed. 

{ } The upper value is the default value (see REFFLD). 

I Specify either the value to the left or the value to the right (may 
refer to optional values). 
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Chapter 2. Physical Files 


This chapter is divided into two sections. The first Positional Entries, provides 
rules and examples for filling in positions 1 through 44 of the Data Description 
Specifications form. To find information in this section, first determine what 
position on the form to use, then look up the section describing that position. 

The second section of this chapter. Keyword Entries, provides rules and 
examples for specifying DDS keywords. The keywords are described in 
alphabetical order. 

For guidance in choosing positional entries and keywords for physical files, see 
the CPF Programmer’s Guide. 

Note: If you are using DDS to describe a source file, you cannot use the 
ABSVAL, DESCEND, NOALTSEQ, SIGNED, UNIQUE, or ZONE keywords. 


DEFINING A PHYSICAL FILE 

A physical file can contain only one record format. Specify the record format in 
either of two ways: 

• Define a new record format: Specify field and key field specifications as 
desired for the new record format. 

• Share an existing record format: Specify, through the FORMAT keyword, 
that CPF is to use a previously defined record format from a physical or a 
logical file. When the FORMAT keyword is used, key field level 
specifications must be specified again even if they were specified on the 
existing record format. 

To define a physical file, specify the entries in the following order: 

1. File level entries (optional) 

2. Record level entries 

3. Field level entries 

4. Key field level entries (optional) 

Note: The file name is provided through the Create Physical File (CRTPF) 
command, not through DDS. 

Complete physical file examples can be found in Appendix F, Examples. 

An explanation of file level, record level, field level, and key field level can be 
found In Chapter 1, Introduction. 

The syntax rules for specifying DDS keywords can be found in Chapter 1, 
Introduction. 


Physical Files 


2-1 



A physical file cannot have more than one record format. The maximum 
number of fields in the record format is 8000; the maximum number of bytes 
in the record format is 32 766. 
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Figure 2-1. Physical File Coding Example 
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Positional Entries (Positions 1-44) 

This section describes how to specify the first 44 positions of the Data 
Description Specifications form for physical files. To code the rest of the form, 
see the section Keyword Entries (Functions Field, Positions 45-80) later in this 
chapter. 

Figure 2-1 shows some positional entries for physical files. 


Positions 1-5 (Sequence Number) 

Use these positions to specify a sequence number for each line on the form. 
The sequence number is optional and is used for documentation purposes only. 


Position 6 (Form Type) 

The A in this position designates this form as a Data Description Specifications 
form. The form type is optional and is for documentation purposes only. 


Position 7 (Comment) 

An asterisk (*) in position 7 identifies the line as a comment line. Comment 
lines can appear anywhere in DDS and are retained only in the source file and 
printed on the source listing. (Comments are not printed on the expanded 
source listing.) Use positions 8 through 80 for comment text. A blank line (no 
characters specified in positions 7 through 80) is treated as a comment line. 


Positions 8-16 (Conditioning) 

These positions do not apply to physical files and must be blank unless an 
asterisk appears in position 7 (which indicates a comment line). 


Position 17 (Name Type) 

The value in this position identifies the type of name in positions 19 through 
28 (name). The valid entries are: 


Entry 

Meaning 

R 

Record format name 

Blank 

Field name 

K 

Key field name 


Note: There can be only one R specified for a physical file because a physical 
file can contain only one record format. 


Physical Files 

Positions 1-5 
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Physical Files 
Position 18 


Position 18 (Reserved) 

This position does not apply to any file and must be blank unless an asterisk 
appears In position 7 (indicates a comment line). 


Positions 19-28 (Name) 

Use these positions to specify the names of the following: 

• The record format for this physical file 

• The field or fields within the record format (unless you specify the FORMAT 
keyword on the record format name) 

• The field or fields to be used as key fields (to establish a keyed sequence 
access path) 

Note: The file name is provided through the create file command, not in the 
DOS. 

When specifying names in DOS, the following rules apply: 

• Names must be 10 characters or less. 

• Names must start In position 19. 

• A name must begin with an alphabetic character (A through Z, @, $, and #). 
All subsequent characters can be alphameric (A through Z, 0 through 9, 

$, #, and underscore (_)). There can be no embedded blanks. 

Figure 2-1 shows how to code the name field; it shows a record format name 
(R specified in position 17), a field name (blank specified in position 17) and a 
key field name (K specified in position 17). 

High-level languages can Impose specific length and value restrictions on the 
name. For example, RPG III accepts only field names of 6 characters or less 
and record format names of up to 8 characters, and they cannot contain an 
underscore. It is your responsibility to ensure that the name syntax used is 
acceptable to all language processors that use the file. 
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Record Format Name 

When you specify R in position 17 (name type), the name specified in positions 
19 through 28 is a record format name. You can specify only one record 
format name for a physical file. Specify the record format name in either of 
two ways: 

• As the name of a new record format with field names specified in this 
physical file. The name of the record format can be the same as the file 
name specified in the create file command; however, a warning message is 
Issued if the names are not unique, because some language processors do 
not allow record format and file names to be the same. RPG III is such a 
language. 

• As the name of a record format previously described in a physical or a 
logical file. Field names and attributes are not specified and the FORMAT 
keyword must be specified. The FORMAT keyword is explained in the 
Keyword Entries section in this chapter. 


Field Name 

When position 17 (name type) is left blank, the name specified in positions 19 
through 28 is a field name. Field entries describe the characteristics of a field 
of data within the record. Field names must be unique within the record 
format. The order in which you specify the field names is the order in which 
the fields appear within the physical record. In physical files, all fields must be 
named. 


Physical Files 
Positions 19-28 
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Physical Files 
Positions 19-28 


Key Field Name 


When you specify K in position 17 (name type), the name specified in positions 
19 through 28 is a key field name. It must be one of the field names within 
the physical file record format. The contents of this field are used to sequence 
the records for retrieval from the data base. Specifying a key is optional; the 
default Is to sequence the records in arrival sequence (the sequence In which 
they were put into the data base). See the CPF Programmer's Guide for 
general information on access paths and for information on the effect of keyed 
or arrival sequence access paths on save/restore operations. 

A key can have more than one key field; such a key is a composite key. For a 
composite key, you must specify the field names in the order of importance 
(major to minor), with each field name on a separate specification line. The 
number of fields that make up a key is restricted; the total key length must not 
exceed 120 bytes. 

For example, suppose a key consists of fields named FIELDA, FIELDS, and 
FIELDC (in that order). The DDS appears as follows: 
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These three fields make up the 
' composite key 


Upon retrieval, the records are sequenced according to the contents of 
FIELDA; if two or more records with the same value in FIELDA exist, CPF 
sequences those records according to the values in FIELDS. If there are two or 
more of those records with the same value in both FIELDA and FIELDS, they 
are sequenced according to the values in FIELDC. 
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Consider the following file: 


Physical Files 

Positions 19-28 


Record 

FIELDA 

FIELDB 
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Assuming ascending sequencing for all fields, the records are retrieved in this 
order: 


Record 
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Note that records 3, 4, 5, and 7 have the same contents in FIELDA, so FIELDS 
becomes the determining field. Within those four records, 5 and 7 have the 
same values in FIELDS, so for these two records, FIELDC becomes the 
determining field. If FIELDC also contains duplicate values, the records are 
retrieved in first-in-first-out (FIFO) order. FIFO is the default order. 
Last-in-first-out (LIFO) processing is available to change this order, and the 
UNIQUE keyword can be specified to prevent duplicate key values. LIFO and 
UNIQUE are described in Keyword Entries later in this chapter. 

See the SIGNED keyword description for an example that includes a key field 
with negative (-) contents. 

There are special restrictions that apply to the specification of key fields when 
FILETYPE(*SRC) is specified on the Create Physical File (CRTPF) or the Create 
Source Physical File (CRTSRCPF) command. See the CPF Programmer's Guide 
for information about key field specification for source files. 


Physical Files 
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Physical Files 

Position 29 


Position 29 (Reference) 

Specify R in this position to use the reference function of CPF to copy the 
attributes of a previously defined named field (called the referenced field). For 
physical files, you must also specify the REF or the REFFLD keyword. The 
referenced field can be previously defined in the physical file you are defining; 
or it can be in a previously created data base file. The field attributes 
referenced are the field's length, data type, and decimal positions, as well as 
editing, validity checking, column heading, and text keywords. 

If you do not specify R, you cannot use the reference function for this field and 
you must specify field attributes for this field. 

Position 29 must be blank at the file and record levels. 

The name of the referenced field cannot be the same as the field you are 
defining if the referenced field is in the file you are defining. If the names are 
the same, you must specify the name of the file defining the referenced field 
as a parameter value with the REF or REFFLD keyword. If the names are 
different, you must specify the name of the referenced field with the REFFLD 
keyword. See the REF and REFFLD keyword descriptions later in this chapter 
and Appendix A, How to Specify REF and REFFLD. 

To override specific attributes of the referenced field, specify those attributes 
for the field you are defining. For example, if you specify the EDTCDE 
keyword or the EDTWRD keyword on the field you are defining, no editing 
specifications are copied from the referenced field. Also, if you specify CHECK 
(AB; ME; MF; M10; M11; VN), COMP, RANGE, or VALUES on the field you 
are defining, no validity checking specifications are copied from the referenced 
field. If you specify data type, field length, or decimal positions for the field 
you are defining, then neither editing nor validity checking keywords are copied 
from the referenced field. 

Note: Once the physical file is created, the referenced file can be deleted or 
changed without affecting the field descriptions in the physical file. To 
incorporate changes made In the referenced file, delete and re-create the 
physical file. 
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Positions 30-34 (Length) 


Physical Files 
Position 30-34 


You must specify a field length unless the length is being duplicated from a 
referenced field. Specify the number of digits for a numeric type field; specify 
the number of characters for a character type field. If you specify length, it 
must be right-justified; leading zeros are optional. The following example 
shows valid and invalid field length specifications: 
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Invalid Length Specification 


Valid Length Specification 


Valid length specifications are: 


Data Type 


Valid Lengths 


Character 

Binary 

Zoned decimal 
Packed decimal 


1 through 32 766 characters 
1 through 9 digits 
1 through 31 digits 
1 through 31 digits 


The sum of the number of bytes occupied by all fields in a record must not 
exceed 32 766. The number of bytes actually occupied is determined by the 
system as follows: 


Data Type 


Bytes Occupied 


Character 

Binary 

1 -4 digits 
5-9 digits 
Zoned decimal 
Packed decimal 


Number of characters 

2 bytes 
4 bytes 

Number of digits 
(Number of digits/2) + 1 


Note: System/38 performs arithmetic operations more efficiently for packed 
decimal than for zoned decimal data type. 


If you are using a referenced field, you can override the length of the field by 
specifying a new value or by specifying an increase or decrease in length. To 
increase the length, specify +n, where n is the Increase. To decrease the 
length, specify -n, where n is the decrease. For example, an entry of +4 for a 
numeric field indicates that it is to be 4 digits longer than the referenced field. 
Figure 2-1 shows how to change and override the field length. 


Note: High-level languages can impose specific length restrictions on the field 
length; these restrictions should be observed for files used by those languages. 
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Physical Files 
Position 35 

Position 35 (Data Type) 

Use this position to specify the data type of the field within the data base. The 
valid data type entries for physical files are: 


Entry 


Meaning 


Numeric types 
P 
S 
B 


Packed decimal 
Zoned decimal 
Binary 


Alphabetic type 
A 


Character 


Figure 2-1 shows how to code the data type. 

If you do not specify a data type and do not duplicate one from a referenced 
field, CPF assigns a default value as follows: 

• A (character) if the decimal positions (36 through 37) are blank 

• P (packed decimal) if the decimal positions (36 through 37) contain a 
number in the range 0 through 31 

Note: Placing 0 in position 37 is a convenient way to specify an integer 
numeric field for any of the three numeric types. 
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Positions 36-37 (Decimal Positions) 


Physical Files 
Positions 36-37 


Use these positions to specify the decimal placement within a packed decimal, 
zoned decimal, or binary field. Specify a decimal number from 0 through 31 to 
indicate the number of decimal positions to the right of the decimal point. (The 
number here must not be greater than the number of digits specified in the 
field length.) Figure 2-1 shows how to code the decimal positions field. 

For all data types, data is actually stored in the system without a decimal 
point; the decimal point is only implied. For example, the value stored for 1.23 
is 123, and this is what appears in display or printer files if editing is not 
specified. 

If you are using a referenced field, these positions can be either overridden or 
changed. To override the positions, specify the new value explicitly. To change 
the positions, specify the amount you want the field Increased or decreased 
and precede it with either a + or -, respectively. For example, an entry of +4 
indicates there are to be 4 more digits to the right of the decimal point than 
were in the referenced field. If the resulting number of decimal positions is 
greater than the maximum allowed, an error message is sent. 

Note: High-level languages can impose specific length and value restrictions 
on the decimal positions; these restrictions should be observed for files used 
by those languages. 


Position 38 (Usage) 

This position does not apply to physical files and must be blank unless an 
asterisk appears in position 7 (which indicates a comment line). 


Positions 39-44 (Location) 

These positions do not apply to physical files and must be blank unless an 
asterisk appears in position 7 (which Indicates a comment line). 


Physical Files 
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Keyword Entries 


Keyword Entries (Positions 45-80) 


This section contains keyword entries valid for defining physical files. They are 
entered in the functions field (positions 45 through 80). See the section Data 
Description Specifications Syntax Ruiesm Chapter 1 for a discussion of the general 
rules for specifying keywords. Figure 2-2 shows how to use the general 
syntax rules for specifying DOS for physical files. 


IBM 


IntarnatioMl Bufinaw Machinal Corporation 


DATA DESCRIPTION SPECIFICATIONS 


GX21-7764-1 UM/OSO' 
Prirtted in U.S.A. 


File 

Keying 

Instruction 

Graphic 








Programmer j Date 

Key 









Description 


nr 


Sequence 

Number 


1 2 3 4 5 


Conditioning 


Condition Name 


19 20 21 22 23 24 25 26 27 28 


Length 


2900 31 32 33 34 


II 






45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 6566 67 68 69 70 71 72 73 74 75 76 77 78 79 80| 
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wim 
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^s»iOi/ii ";)i 
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*Numbar of ahaati par pod may vary dightly. 


Figure 2-2. Syntax for a Physical File 
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The following keywords are valid for physical files: 


Physical Files 
Keyword Entries 


ABSVAL 

ALTSEQ 

CHECK 

CMP 

COLHDG 

COMP 

DESCEND 

DIGIT 

EDTCDE 

EDTWRD 

FORMAT 

LIFO 

NOALTSEQ 

RANGE 

REF 

REFFLD 

SIGNED 

TEXT 

UNIQUE 

VALUES 

ZONE 


Note: When you use DDS to describe a source file (usually created without 
DDS, using the CRTSRCPF command), you cannot use the following keywords: 

ABSVAL 

ALTSEQ 

DESCENT 

LIFQ • 

NQALTSEQ 

SIGNED 

UNIQUE 

ZQNE 


Physical Files 
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Physical Files 
ABSVAL 


ABSVAL 


Use this key field level keyword (absolute values) to specify that when CPF 
sequences the values associated with this numeric key field, it is to ignore the 

sign of the field. 


The following example shows six records with zoned decimal key fields: 


Numeric Key Field 

Hexadecimal 

Record 

(Zoned Decimal) 

Representation 

1 

98 

F9F8 

2 

00 

FOFO 

3 

98- 

F9D8 

4 

97 

F9F7 

5 

20 

F2F0 

6 

99 

F9F9 

If no sequencing keywords are specified, the records are sequenced in this 

order: 

Numeric Key Field 

Hexadecimal 

Record 

(Zoned Decimal) 

Representation 

2 

00 

FOFO 

5 

20 

F2F0 

3 

98- 

F9D8 

4 

97 

F9F7 

1 

98 

F9F8 

6 

99 

F9F9 

If the ABSVAL keyword is specified, the absolute value of the negative field is 

used, and the 

resulting sequence is: 



Numeric Key Field 

Hexadecimal 

Record 

(Zoned Decimal) 

Representation 

2 

00 

FOFO 

5 

20 

F2F0 

4 

97 

F9F7 

1 

98 

F9F8 

3 

98- 

F9D8 

6 

99 

F9F9 
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The ABSVAL keyword is not valid for a field of character data type. You can 
not use this keyword with the SIGNED, the ZONE, or the DIGIT keyword. 

ABSVAL (a key field level keyword) and ALTSEQ (a file level keyword) are 
mutually exclusive; that is, if you specify ABSVAL for a key field, NOALTSEQ 
is in effect for that key field, even if ALTSEQ was specified at the file level 
(whether the NOALTSEQ keyword Is specified or not). 

If you do not specify SIGNED, ABSVAL, ZONE, or DIGIT for a key field, the 
value of the field is treated as a string of unsigned binary data. 

The following Is an example of how to specify the ABSVAL keyword: 


Physical Files 
ABSVAL 






Conditioning 

Name Type (ti/R/K/S/0) I 

■o 

% 

0) 

cc 

18 

Name 

19 20 21 22 23 24 25 26 27 28 

Reference (R) 

Length 

30 31 32 33 34 

1 

z 

> 

X 

w 

< 

m 

OT 

< 

& 

o 

35 

|| 
36 37 

5 

I 

m 

O 

8> 

S 

3 

38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 7 7 78 79 80 

Sequence 

Number 

1 2 3 4 5 

® Form Type 

O 

< 

i 

E 

5 

o 

7 

Z 

o 

z 

8 

Condition Name 

I 

-E 

9 10 

z 

o 

z 

o 

8 

c 

12 13 

z 

o 

z 

14 

- Indicator 
a 

Line 

39 40 41 

Pos 

42 43 44 

odCU,€) 

A 
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ao 
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Physical Files 

ALTSEQ ALTSEQ(alternate-sequence-table-name[.library-name]) 

This file level keyword (alternate sequence) tells CPF that if a key has been 
specified for this file, CPF is to use an alternate collating table when 
sequencing the records of a file member for retreival. Such a table can be 
created by the Create Table (CRTTBL) command. The name of the alternate 
collating table is a required parameter value; the library name is optional. (If a 
library is not specified, the library list, *LIBL, is used.) 

The ALTSEQ keyword is not valid when FILETYPE(*SRC) is specified on the 
Create File command. See the CPF Programmer's Guide for information about 
the FILETYPE(*SRC) parameter value. 

Notes: 

1. Alternate collating sequences are not valid for key fields with a data type of 
packed decimal or binary, or for key fields with SIGNED or ABSVAL 
specified. For these fields, NOALTSEQ (a key field level keyword) is 
assumed and need not be specified. NOALTSEQ can also be specified for 
any field In a composite key not requiring the alternate sequence. 

2. At file creation time, you must have operational rights to the alternate 
collating table. The alternate collating table is created using the Create 
Table (CRTTBL) command. See the CPF Programmer's Guide for more 
information on how to create and enter a table. 

In the following example, records with format DISTR are sequenced by key 
NAME, by means of the alternate collating sequence TABLEl In library 
TABLELIB: 



Conditioning 

:: Name Type («/R/K/S/0) 

Name 

I 

19 20 21 22 23 24 25 26 27 28 2 

i 

> 

Length | 

i 

: a 

8 

1 

9 30 31 32 33 34 3 

< 

5 

? 

5 

t 0 

9 

; ^1' 
m-. 

5 36 37 3 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

o> Form Type 

3 

1 

f 

1 

) i 
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t z 
8 
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to 
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CHECK(edit-check-code [. . .]) 


Physical Files 

CHECK 


This field level keyword checks the validity of data entered in a field of a 
display file by applying one or more edit/check algorithms against the data. 
The keyword does not request any action by data base data management but 
can be specified in the data base file description so that it can be duplicated 
into display file descriptions when this field is referenced at display file 
creation. The rules for specifying this keyword are the same for a data base 
record format as for a display file record format. See Chapter 4, Display Files, 
for information on how to specify this keyword. 

The following edit/check codes are not allowed in data base files even for 
reference purposes: 

Codes Meanings 

FE Field exit check 

RL Right-to-left cursor movement 

RLTB RIght-to-left top-to-bottom cursor movement 


CMP(relational>operator-code constant-value) 

The CMP keyword is equivalent to the COMP keyword. The COMP keyword is 
preferred because it is compatible with DOS on other systems. See the COMP 
keyword description for an explanation of how to use these keywords. 


Physical Files 
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Physical Files 
COLHDG 


COLHDG('line-r ['line-Z' [line-SI]) 


This field level keyword (column heading) specifies column headings to be used 
as a label for this field by the query utility, the data file utility (DFU), and the 
screen design aid (SDA). A maximum of three lines of 20 characters each is 
allowed. 

Each line of the column heading must be enclosed in apostrophes. Use double 
apostrophes (") to specify apostrophes within column headings. One or more 
blanks must be used to separate the first column heading line from the second 
and the second from the third. 

If COLHDG is not specified and is not retrieved from a referenced field, the 
field name is used. If COLHDG is specified and TEXT is not specified, 50 
positions of column heading information are used as text. For example, a 
specification of COLHDG('Order' 'Date') is equivalent to TEXT('Order Date'). 

The following example shows how to specify the COLHDG keyword: 


w~ 


Conditioning 

:: Name Type (IA/R/K/S/0) 

Name 

1 

1 

c 

8 19 20 21 22 23 24 25 26 27 28 

i 

1 

29 

Length 

30 31 32 33 34 

g Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

ll 

36 37 

g Usage (b/O/l/B/H/M) 

Location 

Functions 

46 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

® Form Type 

1 

1 

i 

7 

« Not (N) 

Condition Name 

(0 

^ indicator 
o 

2 

o 

2 

11 

i 

c 

12 13 

2 

o 

2 

14 

i 

1 

16 16 

Line 

39 40 41 

Pos 

42 43 44 
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00170 

A 

- 

- 

-i- 

- 


- 


— 

cim 


—h 

- 

_ U 

- 


- 

-f- 





1-' •a 


— 


The following display illustrates how the column headings could appear when 
executing query, DFU, or SDA. 




Customer 

Order 


City 

Pate 

Customer's Name 

Field 

NNNNN 

XXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXX 


'—__ J 
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COM P(relational-operator-code value) 


Physical Files 
COMP 


This field level keyword (comparison) is a validity checking keyword used when 
fields are referenced by a display file. It does not request any action by data 
base data management but can be specified in the data base file description 
so that it can be duplicated into device file descriptions when this field is 
referenced at device file creation. The rules for specifying this keyword are the 
same for a data base record format as for a device file record format. See 
Chapter 4, Display Files, for information on how to specify this keyword. 


DESCEND 

Use this key field level keyword to specify that the values of this character or 
numeric key field are to be retrieved in descending sequence. If this keyword 
is not specified, ascending sequence is used. See the SIGNED keyword 
description for an example of data sorted with the DESCEND keyword. The 
following example shows how to specify the DESCEND keyword: 




Conditioning 

Name Type (Hi/R/K/S/O) 

Name 

2 

1 

c 

8 19 20 21 22 23 24 25 26 27 28 

<o Reference (R) 

Length 

30 31 32 33 34 

1 

z 

> 

X 

w 

< 

m 

w 

< 

& 

> 

O 

35 

n Decimal 
“ Positions 

S 

I 

m 

O 

D 

38 

Location 

45 46 47 48 49 50 

Functions 

51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

E 

o 

u. 

6 

1 

1 

E 

£ 

cS 

1 

7 

Z 

S 

z 

-ij 

Condition Name 

(D 

^ Indicator 
o 

z 

1 

11 

o 

8 

1 

12 13 

Z 

1 

14 
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Line 
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1 
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Physical Files 
DIGIT 


DIGIT 


Use this key field level keyword to specify that only the digit portion (rightmost 
4 bits) of each byte of the key field is to be used when constructing a value 
associated with this key field. The zone portion is filled with zeros. 

This keyword is applied against the entire key field (not just a position within 
the field); It is valid only for character or zoned decimal type fields. 

You cannot use this keyword with the ABSVAU the SIGNED, or the ZONE 
keyword. 

If you do not specify SIGNED, ABSVAL, ZONE, or DIGIT for a key field, the 
value of the field is treated as a string of unsigned binary data. 

The following example shows how to specify the DIGIT keyword: 




Conditioning 

Name Type (lii/R/K/S/0) | 

1 

18 

Name 

19 20 21 22 23 24 25 26 27 28 

<o Reference (R) 

Length 

30 31 32 33 34 

g Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

w Decimal 
“ Positions 

g Usage (B/O/l/B/H/M) 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

® Form Type 

And/Or/Comment (A/O/*) 

z 

o 

z 

8 

Condition Name 

1 

c 

9 10 

z 

z 

11 

B 

8 

c 

12 13 

Z 

1 

14 

s 

s 

1 
15 16 

Line 

39 40 41 

Pos 

42 43 44 


A 








E 












D/^/ 

71 M ! M M i M M M M i M M M M M i M 

mm 

A 























In this example. If ORDTYP is a 3-byte field, the values of the 
field for three different records could be as follows: 


Values 

Hexadecimal 

Digits Used for Key 

C4J 

C3F4D1 

341 

LMA 

D3D4C1 

341 

3D1 

F3C4F1 

341 
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EDTCDE(edit-code [* | floating-currency-symbol]) 


Physical Files 
EDTCDE 


Use this field level keyword to specify an edit code for editing of output data 
using this current field description. The edit code specification is not used by 
data base data management but is retained in the data base file description so 
that it can be duplicated into a device file description through the reference 
function at device file creation. An edit code is a required parameter value for 
this keyword. 

EDTCDE is valid for numeric fields only. You cannot specify both the EDTCDE 
and the EDTWRD keywords for the same field. You can use the EDTCDE 
keyword to perform edit functions, such as the following: 

• Suppress leading zeros 

• Omit a sign from the low-order position of the field 

• Punctuate the field without having to specify an edit word (see the 
EDTWRD keyword) 

• Perform asterisk fill 

• Specify floating currency symbol 

• Perform user-defined edit functions 


CPF Edit Codes: The edit codes that you can specify as a parameter value for 
this keyword are: 

1 through 4 
A through D 
J through M 
X through Z 

See the EDTCDE keyword descriptions in Chapter 4, Display Files, and Chapter 
5, Printer Files, for summaries of the functions provided by all CPF edit codes 
except X. Edit code X is used only to override the default edit codes used In 
query (default edit code is J) and the data file utility (default edit code Is L). 


User-Defined Edit Codes: You can also specify any of five user-defined edit 
codes (5 through 9). Before creating a device file from DDS source 
containing user-defined edit codes, the user-defined edit codes must exist. 
When you create the device file, the editing information is extracted from the 
user-defined edit codes as referenced in the DDS. Changing user-defined edit 
codes does not affect existing device files unless the device files are 
re-created. See the CPF Programmer's Guide and the CL Reference Manual for 
descriptions of how to create user-defined edit codes if those shipped with the 
system cannot be used. 
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Physical Files 

EDTCDE Asterisk Fill and Floating Currency Symbol: You can specify asterisk fill or 

floating currency symbol with edit codes 1 through 4, A through D, and J 
through M. 

When you specify asterisk fill, an asterisk (*) is written for each zero 
suppressed. A complete field of asterisks is printed for a zero balance field. 

When you specify a floating currency symbol, the symbol appears to the left of 
the first significant digit. The symbol does not print on a zero balance when an 
edit code is used that suppresses the zero balance. The symbol that you 
specify must match the system value for the floating currency symbol 
(QCURSYM) when the file Is created; it does not have to match when the file 
is used. See the CPF Programmer's Guide for a description of how to change 
this symbol. 

The following example shows how to specify the EDTCDE keyword: 




Conditioning 

:: Name Type (M/R/K/S/0) I 

CB Reserved I 

Name 

19 20 21 22 23 24 25 26 27 28 

w Reference (R) 

Length 

30 31 32 33 34 

S Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

^ Decimal 
“ Positions 

S Usage (It/O/I/B/H/M) 

Location 

Functions 

45 46 47 48 49 50 51 52 S3 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

* Form Type 

1 

1 

O 

7 

Z 

I 

8 

Condition Name 

1 

1 

9 10 

Z 

1 

11 
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1 

12 13 
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z 

14 

IS 16 

Line 

3g40 4l 

Pos 

42 43 44 
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See the EDTCDE keyword descriptions in Chapter 4, Display Files, and Chapter 
5, Printer Files, for examples of valid edit codes, source data, and edited 
output. 
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EDTWRD('edft-word') 


Physical Files 
EDTWRD 


If you cannot accomplish the desired editing by using the EDTCDE keyword, 
you can specify an edit word instead. The edit word specification is not used 
by data base data management but is retained in the data base file description 
so that it can be duplicated into device file descriptions through the reference 
function at device file creation. The edit word specifies the form in which the 
field values are to be displayed and clarifies the data by inserting characters 
directly (such as decimal points, commas, floating and fixed currency symbols, 
and credit balance indicators). The edit word can also be used to suppress 
leading zeros and provide asterisk~fill protection. 

The following rules apply when you specify an edit word: 

• The edit word must be enclosed in apostrophes. 

• The EDTWRD keyword is valid for numeric fields only. 

• The number of replaceable characters in the edit word must equal the length 
of the field. 

• When you are using the floating currency symbol, the sum of the number of 
blanks and the stop-zero-suppression character (digit positions) contained in 
the edit word must be equal to the number of positions in the field to be 
edited. The currency symbol is not counted as a digit position. 

For example, if you specify a field length of 7 with 2 decimal positions, the 
edit word must be specified as: 

EDTWRD(’bbbl»$o.bb') 

where the b represents a blank. 

• Any printable character is valid, but the following characters in certain 
positions have special meanings: 

- Blank: A blank is replaced with the character from the corresponding 
position of the data field. A blank position is referred to as a digit 
position. 

- Ampersand: An ampersand causes a blank in the edited field. The 
ampersand is not printed. 

- Zero: A zero stops zero suppression; place a zero in the rightmost 
position where zero suppression is to stop. The zero is replaced with the 
character from the corresponding position of the data field, unless that 
character is zero. Any zeros in the data that appear to the right of the 
stop-zero-suppression character are printed. At least one leading zero is 
suppressed. Each zero that is suppressed Is replaced by a blank. The 
stop-zero-suppression character is considered a digit replace position. 
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EDTWRD “ Asterisk: An asterisk stops zero suppression and replaces zeros with 

asterisks (asterisk protection). Place the asterisk in the rightmost position 
where zero suppression is to stop. Each zero that is suppressed is 
replaced by an asterisk. An asterisk preceding a zero Is Interpreted as 
representing asterisk protection; in this case, the zero prints as a 
constant. An asterisk is considered a digit replace position. 

- Currency Symbol: A currency symbol coded Immediately to the left of the 
zero suppression code causes the insertion of a currency symbol in the 
position to the left of the first significant digit. It is called the floating 
currency symbol when used In this manner. 

A currency symbol coded in the leftmost position of the edit word is 
fixed and prints in the same location each time. When used In this 
manner, it is called the fixed currency symbol. 

The currency symbol is not considered a digit replace position. This 
symbol must correspond to the QCURSYM system value. 

- Decimals and Commas: Decimals and commas are printed in the same 
relative positions in which they are coded In the edit word unless they are 
to the left of the first significant digit. In that case, those positions are 
filled with blanks or replaced by asterisks. 

- All Other Characters: All other characters are printed If they are to the 
right of the significant digits in the data field. If they are to the left of 
the high-order significant digits in the data, those positions are filled 
with blanks or replaced by asterisks if asterisk protection is being used. 

• If you want to show a negative sign with a negative number, include a sign 
in the edit word. Use either the minus sign (-) or the letters CR (credit). 
These print only If the number is negative. 

• You cannot specify both the EDTWRD and EDTCDE keywords for the same 
field. 

See the EDTWRD keyword description in Chapter 4, Display Files, for 

examples of edit words, source data, and edited output. 

The following example shows how to specify the EDTWRD keyword: 


Er“ 


Conditioning 

5 

£ 

6 

|: 

z 

17 

09 Reserved 1 

Name 

i 

j 

•1 

0 

19 20 21 22 23 24 25 26 27 28 2 

Length 

: 

8 

s 

s 

c 

9 30 31 32 33 34 

g Data Type (H A/P/S/B A/S/X/Y/N/l/W) 

^ Decimal 

53 Positions 

1 

I 

:s 

1 

D 

38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 5556 57 58 59 60 61 62 63 64 6566 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

* Form Type 

And/Or/Comment (A/O/*) 

z 

z 

8 

Condition Name 

§ 

1 

9 10 

Z 
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z 

11 

8 

1 

12 13 
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14 

^ Indicator 

Line 

39 40 41 

Pos 

42 43 44 


A 










CKYCST 



1 


IZ 





IM 

RBC'I 1 





M m i Ml i 


P ! 

A 




























1 

A 





























2-24 

































FORMAT(data'base-file’name[.library’nanne]) 


Physical Files 
FORMAT 


Use this record level keyword to specify that this record format is to share the 
specifications for a previously defined record format. The name of the record 
format you are defining must be the name of the previously defined record 
format. The data base file name is required; it is the name of the physical or 
logical file from which the previously defined record format is taken. The 
library name is optional; if you do not specify it, the library list in effect at file 
creation time is used. 

If you specify the FORMAT keyword, you cannot specify field specifications for 
this record format; however, you must specify key specifications if you want 
them to be in effect for this file. (They can be the same as or different from 
the previously defined record format.) 

If the data base file from which you are using the record format is deleted, the 
record format remains in existence as long as some file is using the record 
format. For example, RECORD in FILE2 uses the FORMAT keyword to share 
the specifications of RECORD in FILE1. Both files have been created. If FILEl 
is deleted and then re-created with different DDS, RECORD2 still exists and 
can itself be referenced for the original record format by other files using the 
FORMAT keyword. 

The following example shows how to specify the FORMAT keyword: 


Er“ 


Conditioning 

Name Type (li/R/K/S/O) 

m Reserved 

Name 

19 20 21 22 23 24 25 26 27 28 

<0 Reference (R) 

Length 

30 31 32 33 34 
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D 
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l| 
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I 
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Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

® Form Type 
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The record format for this physical file is the same as the 
previously specified record format in file CUSMSTP. The name 
of this record format (CUSMST) must be the same as the name 
of the record format in CUSMSTP. 
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LIFO 


LIFO 


Use this file level keyword to specify that if records with duplicate key values 
are retrieved from the same physical file member, they are to be retrieved in a 
last-in-first-out (LIFO) order. 

If neither LIFO nor UNIQUE is specified, records that have duplicate key values 
are retrieved in a first-in-first-out (FIFO) order. 

The LIFO keyword is not valid when FILETYPE(*SRC) is specified on the Create 
Physical File (CRTPF) command. See the CPF Programmer’s Guide for more 
Information about the FILETYPE(*SRC) parameter value. 

The following example shows how to specify the LIFO keyword: 


0“ 


Conditioning 

Name Type (IVR/K/S/0) 

Name 

8 19 20 21 22 23 24 25 26 27 28 

® Reference (R) 

Length 

30 31 32 33 34 

S Data Type (li A/P/S/B A/S/X/Y/N/l/W) 

i| 

11 
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$ 

1 

38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 8566 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

® Form Type 

•J And/Or/Comment (A/0/*) 
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NOALTSEQ 

Use this key field level keyword to specify that the ALTSEQ keyword specified 
at the file level is not to apply to this key field. If you specify ABSVAL or 
SIGNED for a key field, NOALTSEQ Is in effect whether or not the NOALTSEQ 
keyword is specified for that key field. 

The following example shows how to code the NOALTSEQ keyword. In this 
example, records with the record format DISTR are sequenced by the 
composite keys CODE and NAME, in which CODE is sequenced by the 
alternate collating sequence TABLE1 in TABLELIB, and NAME is sequenced by 
the EBCDIC collating sequence. NOALTSEQ prevents the sequence of the 
NAME field from being altered. 
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NOALTSEQ 




Conditioning 

:: Name Type (M/R/K/S/O) | 

Name 

19 20 21 22 23 24 25 26 27 28 
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30 31 32 33 34 

^ Data Type (li A/P/S/B A/S/X/Y/N/l/W) 
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RANGEdow high) 

This field level keyword is a validity checking keyword for display files. RANGE 
is not used by data base data management. It is specified in the data base file 
description so that It can be duplicated into display file descriptions when this 
field is referenced at display file creation. The rules for specifying this keyword 
are the same for a physical file as for a display file. See Chapter 4, Display 
Files, for information on how to specify this keyword. 
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Physical Files 
REF 


REF(data-base-file-name[.library-name][record-format-name]) 

Use this file level keyword to specify the name of a file from which field 
descriptions are to be retrieved. Use it when you want to use field attributes 
from several fields in a previously described record format for the file being 
defined. You can specify the file name once in the REF keyword instead of 
specifying it on several REFFLD keywords with each of the field descriptions 
that reference the file. To reference more than one file, use the REFFLD 
keyword. (The REF keyword can be specified only once.) 

If there is more than one record format in the referenced file, you can specify a 
record format name as a parameter value for this keyword to tell CPF which 
one to use, unless the formats should be searched sequentially. 

The file name Is a required parameter value for this keyword; the library name 
and the record format name are optional. 

If you do not specify the library name, the current library list is used. If the 
record format name is not specified, each record format is searched in order 
(as they are specified); the first occurrence of the field name is used. For 
information on how the choice of REF and REFFLD keywords controls these 
searches, see Appendix A, How to Specify REF and REFFLD. 
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REFFLD 


REFFLD(referenced-field-name[.record-format-name] 



*SRC ) 

data-base-file<name[.library-name]/j ^ 


Use this field level keyword when referencing a field under one of these three 
conditions: 


• The name of the referenced field is different from the name in positions 19 
through 28. 

• The name of the referenced field is the same as the name in positions 19 
through 28, but the record format, file, or library of the referenced field is 
different from that specified with the REF keyword. 

• The referenced field occurs in the same DOS source file as the referencing 
field. 


The referenced field name Is required even if it is the same as the referencing 
field. Use the record format name when the referenced file contains more than 
one record format. Use *SRC to search the DOS source file in which the 
referencing field occurs (this is the default value when the data base file name 
and the library name are not specified). Specify the data base file name 
(qualified by Its library name, if necessary) when you want to search a 
particular data base file. 

If, in the same DOS source file, you specify REF at the file level and REFFLD 
at the field level, the REFFLD specification is used. The particular search 
sequence depends on both the REF and REFFLD keywords. For more 
information, see Appendix A, How to Specify REF and REFFLD. 

An R must be specified in position 29. 

The following example shows how to code the REFFLD keyword. Because the 
REF keyword is not specified, the default for line 00030 and 00040 is to search 
the DDS source file in which they are specified. In line 00080, the parameter 
*SRC explicitly specifies the source file. See the example in Appendix A, How 
to Specify REF and REFFLD, for explanations of the various specifications. 
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SIGNED 

This key field level keyword specifies that when sequencing the values 
associated with this numeric key field, CPF is to consider the signs of the 
values (negative versus positive values). SIGNED is not valid for a field of 
character data type. 


The following example shows six records with zoned decimal key fields: 


Numeric Key Field 

Hexadecimal 

Record 

(Zoned Decimal) 

Representation 

1 

98 

F9F8 

2 

00 

FOFO 

3 

98- 

F9D8 

4 

97 

F9F7 

5 

20 

F2F0 

6 

99 

F9F9 

If no sequencing keywords are specified, the records are sequenced in this 

order: 


Numeric Key Field 

Hexadecimal 

Record 

(Zoned Decimal) 

Representation 

2 

00 

FOFO 

5 

20 

F2F0 

3 

98- 

F9D8 

4 

97 

F9F7 

1 

98 

F9F8 

6 

99 

F9F9 

If SIGNED 

is specified, the records 

are sequenced in this order: 


Numeric Key Field 

Hexadecimal 

Record 

(Zoned Decimal) 

Representation 

3 

98- 

F9D8 

2 

00 

FOFO 

5 

20 

F2F0 

4 

97 

F9F7 

1 

98 

F9F8 

6 

99 

F9F9 

If both SIGNED and DESCEND are 

specified, the records are sequenced in 

order: 


Numeric Key Field 

Hexadecimal 

Record 

(Zoned Decimal) 

Representation 

6 

99 

F9F9 

1 

98 

F9F8 

4 

97 

F9F7 

5 

20 

F2F0 

2 

00 

FOFO 

3 

98- 

F9D8 

Note: SIGNED is the same for logical and physical files. 
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SIGNED (a key field level keyword) and ALTSEQ (a file level keyword) are 
mutually exclusive. If you specify SIGNED for a key field, NOALTSEQ is in 
effect for that key field even if ALTSEQ is specified at the file level (whether 
NOALTSEQ is specified or not). 


If you do not specify SIGNED, ABSVAL, ZONE, or DIGIT for a key field, the 
value of the key is treated as a string of unsigned binary data. 


The following example shows how to specify the SIGNED keyword: 


□- 
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:5 Name Type (IVR/K/S/O) 
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rr 

18 

Name 

19 20 21 22 23 24 25 26 27 28 

<0 Reference (R) 

Length 

30 31 32 33 34 

g Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

i| 
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36 37 

5 

I 
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38 

Locatiori 
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45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 
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TEXT('description') 

Use this record or field level keyword to supply a text description with this 
record format. The text description must be enclosed in apostrophes, with a 
maximum of 50 characters. If more than 50 characters are specified, the 
keyword is accepted; however, the excess characters are dropped and a 
warning message is issued. 

You can specify TEXT at both the record format level and the field level. 
However, both TEXT and FQRMAT cannot be specified at the record format 
level, because the format already contains text. 

The following examples show how to specify the TEXT keyword: 


a- 

Conditioning 

5 Name Type (M/R/K/S/0) 

Name 
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If TEXT is not specified and COLHDG is specified, 50 positions of column 
heading information are used as a default for text. If COLHDG is not specified, 
there is no text, unless it is retrieved from a referenced field. 
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If the TEXT keyword is not specified, the information specified on the 
COLHDG keyword is used for the text as if coded as follows: 
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^ Name Type (tS/R/K/S/O) 
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UNIQUE 

Use this keyword at the file level to specify that records with duplicate key 
values are not allowed within a member of this physical file. Any inserts or 
additions of new records, or updates to existing records, that would result In a 
duplicate key are rejected. The application program issuing the write or the 
update operation receives a message. When a work station user is using DFU, 
a message is displayed at the work station. A copy file command copying 
records that would have duplicate keys in this file cannot be completed. 

When a logical file based on this physical file has the UNIQUE keyword, the 
physical file member or members cannot have records with duplicate keys. 

When the UNIQUE keyword is specified for a physical file, the 
MAINT(*IMMED) parameter value must be specified on the Create Physical File 
(CRTPF) command that creates the file. This means that the access path Is 
maintained Immediately as changes are made. See the CPF Programmer's 
Guide for a description of the MAINT(*IMMED) parameter value. 

If the UNIQUE keyword is not specified, records with duplicate key values are 
sequenced in first-in-fIrst-out (FIFQ) order, unless the LIFQ keyword is 
specified. In which case they are sequenced in last-in-first-out order. For an 
explanation of how records with duplicate key values are sequenced when 
those records are not in the same file member, see the section on data base 
records in the CPF Programmer's Guide. 

The following example shows how to specify the UNIQUE keyword: 




Conditioning 

Name Type (K/R/K/S/O) I 

1 

i 

QC 

18 

Name 

19 20 21 22 23 24 25 26 27 28 

« Reference (R) 

Length 

30 31 32 33 34 

S Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

^ Decimal 
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m 
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3 
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Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 
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1 2 3 4 5 
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And/Or/Comment (A/0/*) 
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1 
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VALUES(value-1 [value-2 . . .[value-201]) 


Physical Files 

VALUES 


This field level keyword is a validity checking keyword for display files. It does 
not request any action by data base data management, but can be specified in 
the physical file so that it can be duplicated into display file descriptions when 
this field is referenced at display file creation. The rules for specifying this 
keyword are the same for a data base record format as for a display file record 
format. See Chapter 4, Display Files, for information on how to specify this 
keyword. 


ZONE 

Use this key field level keyword to specify that only the zone portion (leftmost 
four bits) of each byte of the key field is to be used when constructing a value 
associated with this key field. The digit portion is filled with zeros. 

This keyword is applied against the entire key field (not just a position within 
the field), and it is valid only for character or zoned decimal type fields. 

You cannot use ZONE with the ABSVAL, SIGNED, or DIGIT keywords. 

If you do not specify SIGNED, ABSVAL, ZONE, or DIGIT for a key field, the 
value of the field is treated as a string of unsigned binary data. 

The following example shows how to specify the ZONE keyword: 
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In this example, if CODE is a 1-byte field, the values of the field for 
three different records could be as follows: 


Values Hexadecimal Zone Used for Key 

A CO C 

B Cl C 

E C4 C 
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Chapter 3. Logical Files 


This chapter is divided into two sections. The first Positional Entries, provides 
rules and examples for filling in positions 1 through 44 of the Data Description 
Specifications form. To find information in this section, first determine what 
position on the form to use, then look up the section describing that position. 

The second section of this chapter. Keyword Entries, provides rules and 
examples for specifying DDS keywords. The keywords are described in 
alphabetical order. 

For guidance in choosing positional entries and keywords for logical files, see 
the CPF Programmer's Guide. 
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DEFINING A LOGICAL FILE 


To define a logical file, specify the entries in the following order: 


1. 

File level entries (optional) 


2. 

Record level entries 


3. 

Field level entries (optional) 

Repeat these entries for 
► each record format in 
the file. 

4. 

Key field level entries (optional) 

5. 

Select/omit level entries (optional) 



Note: The file name is provided through the Create Logical File (CRTLF) 
command, not through DDS. 

Complete logical file examples can be found in Appendix F, Examples. 

An explanation of file level, record level, field level, key field level, and 
select/omit field level can be found in Chapter 1, Introduction. 

The syntax rules for specifying DDS keywords can be found in Chapter 1, 
Introduction. 

For the maximum number of record formats in a logical file, see the PFILE 
keyword description in the Keyword Entries section in this chapter. The 
maximum number of fields in any one record format is 8000; the maximum 
number of bytes in any one record format is 32 766. 



SPECIFYING MORE THAN ONE RECORD FORMAT IN A LOGICAL FILE 


When you specify more than one record format in a logical file, each record 
format requires the PFILE keyword. In a logical file, there are three ways to 
specify the fields to be used in any record format, as follows: 

• Specify only the record format name and the PFILE keyword. 

• Specify only the record format name, the PFILE keyword, and the FORMAT 
keyword. 

• Specify the record format name, the PFILE keyword, and individual 
fields as needed. 

Each of the above ways of specifying the fields in a record format can also 
have the following access path specifications: 

• Specify no key fields and no select/omit fields (arrival sequence access 
path; only one record format with one based-on physical file can be 
specified for the logical file). 

• Specify one or more key fields (keyed sequence access path; all record 
formats in the logical file must have at least one key field specified). 

• Specify the ACC PTH keyword (keyed sequence access path; the file you are 
defining shares an access path defined by another physical or logical file). 

In addition, In any logical file with a keyed sequence access path, select/omit 
fields can be specified for any number of the record formats in the file. 
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Figure 3-1. Logical File Coding Example 
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Positional Entries (Positions 1-44) 

This section describes how to specify the first 44 positions of the Data 
Description Specifications form for logical files. To code the rest of the form, 
see the section Keyword Entries (Functions Field, Positions 45-80) in this 
chapter. 

Figure 3-1 shows some positional entries for logical files. 


Positions 1-5 (Sequence Number) 

Use these positions to specify a sequence number for each line on the form. 
The sequence number is optional and is used for documentation purposes only. 


Position 6 (Form Type) 

The A in this position designates this as a Data Description Specifications 
form. The form type is optional and is for documentation purposes only. 


Position 7 (Comment) 

An asterisk (*) In position 7 Identifies the line as a comment line. Comments 
can appear anywhere in DDS and are retained only in the source file and 
printed on the source listing. (Comments are not printed on the expanded 
source listing.) Use positions 8 through 80 for comment text. A blank line (no 
characters specified in positions 7 through 80) is treated as a comment line. 


Positions 8-16 (Conditioning) 

These positions do not apply to logical files and must be blank unless an 
asterisk appears in position 7 (indicates a comment line). 


Position 17 (Name Type) 

The value in this position identifies the type of name specified in positions 19 
through 28 (name). The valid entries are: 


Entry 

Meaning 

R 

Record format name 

Blank 

Field name or select/omit AND condition 

K 

Key field name 

S 

Select field name 

0 

Omit field name 


Logical Files 

Positions 1-5 


Logical Files 
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Logical Files 

Position 18 


Position 18 (Reserved) 

This position does not apply to any file and must be blank unless an asterisk 
appears in position 7 (indicates a comment line). 


Positions 19-28 (Name) 

Use these positions to specify the names of the following: 

• The record format or formats for this logical file 

• For each record format the field or fields that make up the record format 
(unless you specify the FORMAT keyword at the record level) 

• For each record format the field or fields to be used as key fields 

• For each record format the field or fields to be used for select/omit 
specifications 

When specifying names in DOS, the following rules apply: 

• Names must be 10 characters or less. 

• Names must start in position 19. 

• The name must begin with an alphabetic character (A through Z, @, $, and 
#) or asterisk (*) (for *NONE). All subsequent characters can be alphameric 

(A through Z, 0 through 9, @, $, #, and underscore (_)). There can be no 

embedded blanks. 

• The type of name must be specified in position 17, unless you are 
specifying a field name or select/omit AND condition. 

Figure 3-1 shows how to code the name field. 

High-level languages can impose specific length and value restrictions on the 
name field. For example, RPG III accepts only file names of 8 characters or 
less, record format names of 8 characters or less, and field names of 6 
characters or less, and they cannot contain an underscore. It is your 
responsibility to ensure that the name syntax used here is acceptable to all 
language processors that process the file. 
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Record Format Name 


Logical Files 
Positions 19-28 


When you specify R in position 17 (name type), the name specified in positions 
19 through 28 is a record format name. More than one record format name 
can be specified for a logical file, but each must be unique within that file. (See 
the appropriate high-level language manual for exceptions.) Specify the record 
format name In one of three ways: 

• As the record format name in the first physical file specified on the PFILE 
keyword. This is required if you do not specify the FORMAT keyword and if 
you do not define individual fields in this record format. 

• As the name of a new record format with field names specified in this 
logical file. The name of the record format can be the same as the file 
name specified in the create file command; however, a warning message Is 
issued if the names are not unique, because some language processors do 
not allow record format and file names to be the same. RPG III is such a 
language. 

• As the name of a record format previously described in a physical or logical 
file. Field names and attributes are not specified and the FORMAT keyword 
must be specified. The FORMAT keyword is explained in the Keyword 
Entries section in this chapter. 

Use the PFILE keyword in conjunction with the record format name to specify 
the physical file(s) with which the record format is to be associated. A record 
format can be used with more than one physical file. If no fields are defined 
and the FORMAT keyword is not specified, the format of the first file specified 
in the PFILE keyword is used as the format for all the physical files. (This 
format is used for field attribute references and attribute and name checking.) 


Logical Files 
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Logical Files 
Positions 19-28 


Field Name 

When position 17 (name type) Is left blank, the name specified in positions 19 
through 28 is a field name. Each field in a logical file must be named. The 
order in which you specify the field names is the order in which the fields 
appear to programs that use the logical file. Each field name must be unique 
within the record format and must correspond to a field In the physical file 
record format. 

The name you give to a field in a logical file record format will usually be the 
same as the name of the corresponding field in the physical file record format. 
If different the two names must be equated by using the RENAME keyword. 

A field in a logical file record format can also represent the concatenation of 
two or more fields from the physical file. (See the CONCAT keyword.) 

Note: The sequence in which the field names are specified in the logical file is 
important. If the same physical field is specified more than once in a record 
format in the logical file (that is, by using either RENAME or CONCAT), the 
sequence in which the fields are specified in the logical file is the sequence in 
which the data is moved to the physical file. Thus, the value of the field the 
last time the field is specified in the logical file is the value in the physical 
record. If a renamed (RENAME keyword) or concatenated (CONCAT keyword) 
field is used as a key field, the value of the key for the purposes of ordering 
the record is the value assigned to the first occurrence of the field in the 
record format. 
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Key Field Name 

When you specify K in position 17 (name type), the name specified in positions 
19 through 28 is a key field name. Use key fields (and optionally, select/omit 
fields) to define a keyed sequence access path for record formats in the logical 
file member. (The logical file member includes the physical file members 
specified on the DTAMBRS parameter on the Create Logical File (CRTLF) or 
Add Logical File Member (ADDLFM) commands.) 

If you specify more than one record format for a logical file or more than one 
physical file for the PFILE keyword, you must specify at least one key field for 
all record formats of that logical file. A key can have more than one key field; 
such a key is a composite key. 

The following example shows a logical file with two record formats, one of 
which uses a composite key: 
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In this example, RECORD1 has a single key field, FIELD1. RECORD2 
has a composite key that Includes FIELD4 and FIELDS. 

In a composite key, specify the key field names in the order of 
importance (major to minor), and specify each key field name on a 
separate line. 
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Positions 19-28 
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If you specify no key field, the logical file you are defining has an arrival 
sequence access path. Also, without at least one key field specified, you 
cannot specify select/omit fields. 

The number of fields that make up a key is restricted in that the total key 
length cannot exceed 120 bytes. The total key length includes the length of 
each key field. When you specify more than one record format in a logical file, 
add 1 byte for each key field (CPF uses the extra byte when records from 
different physical files have duplicate key values). 

Fields that you specify as key fields must exist in the logical file record format 
as well as In the ph slcal file record format, and the key field name must be 
the name specified for the field in the physical file record format. Data type, 
length, and decimal positions of the field in the physical file record format 
cannot be overridden in the logical file record format; they must be the same 
as in the physical file record format. The field used as a key field must exist at 
the field level in the record format as well as at the key field level. If you do 
not specify field names at the field level, the field must exist in the record 
format specified with the FORMAT keyword or in the record format of the first 
physical file specified with the PFILE keyword. 

You can specify one or more access path keywords to affect the way CPF 
builds and uses key values. The access path keywords are the following: 

File Level 

ACCPTH 
ALTSEQ 
LIFO 
UNIQUE 

Key Field Level 

DESCEND 

DIGIT 

NOALTSEQ 

SIGNED 

ZONE 

Different key fields within a composite key can have different access path 
keywords. 



Logical Files with More Than One Record Format: When you specify more than 
one record format in a logical file, you must specify at least one key field for 
every record format in the logical file. It is not necessary to specify the same 
number of key fields in each key. Also, key fields specified in one record 
format must have the same field attributes and access path keywords as the 
corresponding key fields In other record formats in the same logical file. 

A key is required for every record format so that the logical file member can 
have a single access path sequencing records of each record format. When 
records are returned from the various based-on physical file members, they are 
merged according to the values of the key fields in the access path for the 
logical file member. 

When records of a logical file member are sequenced, CPF builds a key value 
for each record by concatenating the values in its key fields. The key value is 
then used to build the access path for use by your program. See the section 
on data base records in the CPF Programmer's Guide for information about the 
I/O operations permitted by CPF. 

Each key field In a composite key has a key position. The first key field 
specified is in position 1, the second key field specified Is in position 2, and so 
on. During I/O operations to a logical file, CPF compares the key values of the 
records written to or read from the data base. When you create a logical file 
that has more than one record format (with or without different key fields 
specified), CPF performs key position attribute checking. For key position 
attribute checking to succeed, key fields of different record formats that are in 
the same key positions must have the same data type, length, decimal 
positions, and access path keywords specified at the key field level. This 
ensures a meaningful record sequence from the comparisons made during an 
I/O operation. For example, in the following logical file, FIELD1 and FLD1 
must have the same attributes, and FIELD2 and FLD2 must have the same 
attributes. FIELD1 and FLD1 are in key position 1, and FIELD2 and FLD2 are 
in key position 2. 
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Logical Files 
Positions 19-28 


For examples of key fields in a logical file with more than one record format 
refer to Figure 3-1. In Figure 3-1, fields named ITEM are specified in each 
key. For record formats INVFMT and ACTFMT, ITEM is the only key field 
specified.'For-record format ORDFMT, a composite key is specified. This 
composite key includes ITEM, SHPYR, SHPMO, and SHPDA. Each of the 
fields used in a key must also exist at the field level; therefore, ITEM must 
exist in the record format for the physical file INVENTORY so that It can be 
copied into this logical file for INVFMT. Also, ITEM must exist in the record 
format for the logical file ACCOUNTL so that it can be copied into this logical 
file for ACTFMT. (ITEM must also exist in physical file ACCOUNTS.) 


How to Use *NONE: Two conditions can occur in which key fields having the 
same key position should not be compared. The two conditions are: 

• The key fields do not have the same field attributes (data type, length, 
decimal positions, or access path keywords at the field level). 

• The key fields have the same attributes, but you do not want them to be 
merged and sequenced together. 

To avoid Invalid or unwanted comparisons between key fields, specify *NONE 
in place of one of them, and move the displaced key field to the next key 
position. CPF compares the values of key positions before and after *NONE, 
but retrieves the affected records in the order in which the record formats are 
specified in the DOS for the logical file. 

Note: You can specify *NONE two or more times on succeeding lines to 
displace a key field to a key position for which a comparison of key field 
attributes is relevant to your application. 
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Logical Files 

Positions 19-28 


Example 1: A logical file views records of two physical files through two 
different record formats, CLSHST (class history) and JOBHST (job history). In 
the logical file, the records from the two physical files can be merged together 
and sequenced by employee identification number (EMPNBR) by specifying 
EMPNBR in key position 1. 

All records that have the same key value for EMPNBR pertain to the same 
employee. To merge and sequence all records for a given employee into a 
single history of classes and job assignments, specify CLSDTE (date of class) 
and JOBDTE (date of job assignment) in key position 2 for the two record 
formats, as follows: 



CLSHST 

EMPNBR 

CLSDTE 

JOBHST 

EMPNBR 

JOBDTE 
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Logical Files 
Positions 19-28 


Suppose that the job assignment dates and class dates are the dates 
(month/year) that the class or assignment started. Records for three students 
are retrieved in the following order: 


EMPNBR 

CLSDTE 

JOBDTE 

Description 

1005 

3/79 


Completed class 

1005 

4/79 


Withdrew to begin new job 

1005 


4/79 

Completed job 

1005 

6/79 


Completed class 

1006 


1/79 

Completed job 

1006 


2/79 

Completed job 

1006 

3/79 


Completed class 

1006 

5/79 


Transferred to new location 

1007 


1/79 

Completed job 

1007 


4/79 

Completed job 

1007 


7/79 

Completed job 

1007 

8/79 


Withdrew because of Illness 


Note: Such a report provides a continuous history for each student. 
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Example 2: Another logical file views the same two physical files as in 
example 1, but the second record format in the logical file has *NONE 
specified in key position 2, as In the following DDS: 


Logical Files 
Positions 19-28 
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Logical Files 
Positions 19-28 


As in example 1, all records from the two physical files are first merged and 
sequenced together on employee number (EMPNBR); however, the records for 
each student are merged and sequenced first on class date (CLSDTE) and then 
on job assignment date (JOBDTE). The set of records used for example 1 are 
retrieved as follows: 


EMPNBR 

CLSDTE 

JOBDTE 

Description 

1005 

3/79 


Completed class 

1005 

4/79 


Withdrew to begin new job 

1005 

6/79 


Completed class 

1005 


4/79 

Completed job 

1006 

3/79 


Completed job 

1006 

5/79 


Transferred to new location 

10P6 


1/79 

Completed job 

1006 


2/79 

Completed job 

1007 

8/79 


Withdrew because of illness 

1007 


1/79 

Completed job 

1007 


4/79 

Completed job 

1007 


7/79 

Completed job 


When several adjacent record formats have *NONE in the same key position, 
they form a set, relative to record formats specified before and after them, that 
functions in sequencing as an individual record format. Key fields specified 
after *NONE serve to merge and sequence records of the formats within the 
set. The following example shows how several record formats function as a 
set. 
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Example 3: Consider a logical employee file over five physical files. The five 
record formats are defined as follows: 


Logical Files 
Positions 19-28 
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Record Format 

D 

Key Positions 
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EMPMST 

EMPNBR 

*N0NE 

*N0NE 

CLSREG 

EMPNBR 

CLSDTE 

*N0NE 

CLSHST 

EMPNBR 

CLSDTE 

*N0NE 

JOBHST 

EMPNBR 

•NONE 

JOBDTE 

ACTHST 

EMPNBR 

*N0NE 

ACTDTE 
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Logical Files 
Positions 19-28 


The records are merged and sequenced as follows: 

1. All records are merged and sequenced by employee number. 

2. For a given employee, records are sequenced by: 

a. The master record (of the EMPMST format) 

b. Records of the CLSREG and CLSHST formats, merged and sequenced 
together on values of CLSDTE (key position 2) 

c. Records of the JOBHST and ACTHST formats, merged together and 
sequenced together on values of JOBDTE and ACTDTE (key position 
3) 

*NONE in the key definitions achieves this sequencing as follows: 

• *NONE and a field name, CLSDTE, appear in the second key position of the 
adjacent formats, CLSHST and JOBHST. This effectively causes a split 
between the two formats after the preceding key position (position 1). 
Records of formats above the split are merged and sequenced with records 
of formats below the split only on values of EMPNBR. 

• An implicit *NONE in the second key position of the format EMPMST forces 
a similar split. 

• With *NONE in key position 2, the JOBHST and ACTHST formats form a 
set in which the values of JOBDTE and ACTDTE are compared in order to 
merge and sequence records of these two formats only. 

Note that the record sequence defined by the previous key specifications is 
totally dependent on the order In which the formats are specified. For example. 
If JOBHST had been specified before CLSHST so that key position 2 reads 

*NONE, CLSDTE, *NONE, CLSDTE, *NONE, 

the values of CLSDTE within CLSREG would not have been sequenced with 
the values of CLSDTE within CLSHST, and JOBDTE would not have been 
sequenced with ACTDTE. 
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Logical Files 

Example 4: Assume that an employee has repeated a class. To sequence two Positions 19-28 

records with the same values for EMPNBR and CLSDTE, a third key field, 

DATE, is specified in record format CLSHST. However, DATE cannot be 
specified in the next available key positipn (position 3) because JOBDTE and 
ACTDTE appear in that position for other formats. If DATE is specified in this 
position, the attributes of DATE are compared with the attributes of CLSHST 
and JOBHST, and the key definitions are rejected. 

To obtain the sequencing necessary, specify *NONE before DATE, displacing 
DATE to key position 4. 

The DATE field can be shown in position 4 as follows: 
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Record Format Key Positions 

O B D □ 


EMPMST 

EMPNBR 

*N0NE 

*N0NE 

*NONE 

CLSREG 

EMPNBR 

CLSDTE 

*N0NE 

*N0NE 

CLSHST 

EMPNBR 

CLSDTE 

*NONE 

dateO 

JOBHST 

EMPNBR 

*NONE 

JOBDTE 

•none 

ACTHST 

EMPNBR 

*N0NE 

ACTDTE 

•none 


Specifying DATE O in key position 4 enables records from physical file 
CLSHSTP with Identical values for EMPNBR and CLSDTE to be merged and 
sequenced according to the value for DATE. See the CPF Programmer's 
Guide for detailed information regarding records with duplicate key 
values. 
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Logical Files 

Positions 19-28 


Select/Omit Field Name 


Use select/onnit fields to tell CPF how to select or omit records when your 
program retrieves them using this record format. The only records affected are 
those from the physical file(s) specified for the PFILE keyword for this record 
format. If you do not specify any key field names, you cannot specify 
select/omit field names. 

When using select/omit fields, specify either S or 0 (or leave It blank for an 
AND condition) In position 17. In positions 19 through 28, specify a field name 
whose contents at execution time determine whether the record Is to be 
selected or omitted based upon the select/omit keyword specified for this 
field. The select/omit keywords are COMP, RANGE, and VALUES. The last 
select/omit specification can be made with the ALL keyword, but no field 
name is permitted. 

The field must appear in both the physical file record format and the logical file 
record format. The field can be renamed or be part of a concatenated field as 
long as it exists in the record format. The name you specify must be the one 
in the physical file. Select/omit statements must follow all field and key field 
level entries for the record format. Both select and omit can be specified for 
the same record format. The following information applies: 

• If you specify both select and omit for a record format, the order in which 
they are specified Is important. The select/omit statements are processed in 
the order they are specified; if a record satisfies a statement, the record is 
either selected or omitted as specified, and remaining select/omit 
statements are not examined. 

• If you specify both select and omit statements, you can indicate whether 
records not meeting any of the criteria specified are to be selected or 
omitted. (See the ALL keyword.) 

• If you do not specify the ALL keyword, the action taken for the records that 
do not meet the criteria is the converse of the type of the last statement 
specified. The records that do not meet selection criteria are omitted; 
records that do not meet omission criteria are selected. 

There are limits to the number of select/omit statements you can specify in a 
single logical file. If you specify many select/omit statements and you cannot 
create the file, reduce the overhead for the file through the following changes 
in the specifications, in decreasing order of Importance: 

• Reduce the number of record formats in the file. 

• Reduce the number of physical files specified on the PFILE keyword. 

• Reduce the number of fields used (single occurrences) in the select/omit 
specifications. 
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In this example, you want to select all the records before 1978 for a sales 
representative named JSMITH in the state of New York. There are three 
ways to code this example. 

Q All records must be compared with the select fields ST, REP, and 
YEAR before they can be selected or omitted. 

Q All records in and after 1978 are omitted in the first comparison. 

Then, only the records before 1978 are compared with ST and REP. 
Only two select fields must be satisfied. This way Is more efficient 
than the way used in D. 


All records that are not associated with JSMITH in the state of New 
York are omitted in the first and second comparisons. Then, all 
records left are compared to YEAR. This way is more efficient than 
the ways in Q and Q. 
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Logical Files 
Position 29 


Position 29 (Reference) 

If R is specified in position 29, the R is blanked and ignored. All logical files 
automatically provide the reference capability for all specified fields. Any 
attributes that are not specified explicitly In the logical file are furnished from 
the corresponding field In the physical file record format. 


Positions 30-34 (Length) 

If the length of the corresponding field in the associated physical file is 
acceptable to your program, this attribute need not be specified. If you do 
specify length, it must be right-justified; leading zeros are optional. The 
following example shows valid and Invalid field length specifications: 



Valid length specifications are: 


Data Type 


Valid Lengths 


Character 

Binary 

Zoned decimal 
Packed decimal 


1 tlirough 32 766 characters 
1 through 9 digits 
1 through 31 digits 
1 through 31 digits 


The sum of the number of bytes occupied by ail fields in a record format must 
not exceed 32 766. The number of bytes actually occupied Is determined by 
the system as follows: 


Data Type Bytes Occupied 


Character 

Binary 

1 -4 digits 
5-9 digits 
Zoned decimal 
Packed decimal 


Number of characters 

2 bytes 
4 bytes 

Number of digits 
(Number of dlgits/2) + 1 


Note: System/38 performs arithmetic operations more efficiently for packed 
decimal than for zoned decimal data type. 
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You can override the length of the field by specifying a new value or by 
specifying the increase or decrease in length. To increase the length, specify 
+n, where n is the increase. To decrease the length, specify -n, where n is the 
decrease. For example, an entry +4 indicates that a numeric field is to be 4 
digits longer in this logical file than it is in the associated physical file. Figure 
3-1 shows how to change and override the field length. 

If the corresponding field in the physical file record format has a data type of 
binary with decimal positions greater than zero, the length cannot be 
overridden here. If the field you are describing is a concatenation of fields 
from the associated physical record format, you cannot specify the length here. 
The sum of the physical field lengths is used. 

The field is always a fixed length. If the value of the field Is numeric and fits 
into a smaller number of positions, it is automatically right-justified with zeros. 
It is left-justified with blanks if it is character data type. If the data is dropped 
because it is too long, no error is signaled. Figure 3-1 shows how to code the 
length field. 

These positions are valid only for field specifications and must be blank for 
key, select/omit, and record format level specifications. 

Note: High-level languages can restrict the field length; any such restriction 
should be observed for files used by these languages. 


Logical Files 

Positions 30-34 
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Logical Files 

Position 35 


Position 35 (Data Type) 

Use this position to specify the data type of the field when it is presented to 
your program. 

The valid entries for logical files are: 

Entry Meaning 

Numeric types 
P 
S 
B 

Alphabetic type 

A Character 


Packed decimal 
Zoned decimal 
Binary 


Figure 3-1 shows how to code the data type. 

Any conversion of data types from the physical file record format is permitted 
within the numeric types (for example, a binary field in the physical file 
converted to zoned decimal in the logical file); however, if a binary field in the 
physical file record format has decimal positions greater than zero, the data 
type cannot be overridden in the logical file. 

You can convert zoned decimal fields to character fields and the converse, 
provided that the field lengths are the same. It is your responsibility to ensure 
that the data is valid. For example, if the field is zoned decimal in the physical 
file and you specify character type (A) for presentation to your programs, you 
must ensure that the field contains only decimal data when it is returned 
through the logical file to the physical file on which it is based. 


If the field in the physical file corresponding to the one you are defining has a 
data type that is acceptable to your programs, you need not specify the data 
type. 


If the field you are defining is a concatenation of fields from the associated 
physical file (specified by the CONCAT keyword), you cannot specify the data 
type. It is assigned by CPF as follows: 

Included Fields Concatenated Field 


Numeric (B,S,P) 

Character 

Mixed 


Zoned decimal 

Character 

Character 
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Positions 36-37 (Decimal Positions) 

If the placement of the decimal point in the corresponding field in the physical 
file is acceptable to your program, leave positions 36 through 37 blank. 

To override or change the placement of the decimal point within a packed 
decimal or zoned decimal field, specify a number from 0 through 31 to indicate 
the number of decimal positions to the right of the decimal point. (The number 
here must not be greater than the number of digits specified in the field 
length.) Figure 3-1 shows how to specify decimal positions. 

You can specify a value either to override or to change the corresponding value 
in the physical file. To override the value, specify the new value. To change 
the value, specify the amount you want the field increased or decreased and 
precede it with either a + or -, respectively. For example, an entry of +4 
indicates there are to be 4 more digits to the right of the decimal point than 
there were in the corresponding field in the physical file. 

If you specify a value in positions 36 through 37 and your program sends or 
retrieves data through the logical file field to the physical file field, CPF aligns 
the data on the decimal point. Depending on the case, this can cause the 
truncation of decimal values or a data conversion error (CPF issues CPF 5029 
to your program). Decimal values are truncated in the following cases: 

• When reading from a logical file that reduces the number of decimal 
positions specified in the physical file 

• When writing to a logical file that increases the number of decimal positions 
specified in the physical file 

For example, if the physical file field is defined as 4 digits long with 2 decimal 
positions and the logical file field decreases the decimal positions to 0 decimal 
positions, a value of 0.20 in the physical file becomes a value of 0 in the 
logical file, and a value of 2.52 In the physical file becomes a value of 2 in the 
logical file. 

When decimal values are truncated, the left side of the field is filled with zeros. 
A data conversion error can occur in the following cases: 

• When writing to a logical file that reduces the number of decimal positions 
specified in the physical file 

• When reading from a logical file that increases the number of decimal 
positions specified in the physical file 

The data conversion error occurs because too many digits would be moved 
into the space available to the left of the decimal point. For example, if, as in 
the previous example, the physical file field is defined as 4 digits long with 2 
decimal positions and the logical file field decreases the decimal positions to 0 
decimal positions, a value of 3322 written to the logical file cannot fit in the 
physical file (only 2 digits are allowed left of the decimal point in the physical 
file). 


Logical Files 

Positions 36-37 


Logical Files 
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Logical Files 

Position 38 


To avoid data conversion errors, increase or decrease the length (positions 30 
through 34) of the logical file field by the same amount that you increase or 
decrease the decimal positions. 


If the field being described is a concatenation of fields from the associated 
physical file, you cannot specify decimal positions. (A field in the physical file 
that contains decimal positions cannot be included in a concatenated field.) 

You cannot override decimals for binary fields (data type B). When the 
corresponding field in the physical file is binary and contains decimal positions 
greater than zero, the decimal positions in the physical file record format are 
used. When the logical file field is binary and the corresponding field in the 
physical file is not binary, the decimal positions must be zero. 

Note: High-level languages can impose specific length and value restrictions 
on the decimal positions; these restrictions should be observed for files used 
by those languages. 


Position 38 (Usage) 

This position does not apply to logical files and must be blank unless an 
asterisk appears in position 7 (which indicates a comment line). 


Positions 39-44 (Location) 

These positions do not apply to logical files and must be blank unless an 
asterisk appears in position 7 (which indicates a comment line). 
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Keyword Entries (Positions 45-80) 


Logical Files 
Keyword Entries 


This section contains keyword entries valid for defining logical files. They are 
entered in positions 45 through 80 (functions). See the section Data 
Description Specifications Syntax Ruies in Chapter 1 for a discussion of the 
general rules for specifying keywords. Figure 3-2 shows how to use the 
general syntax rules for specifying DDS for logical files. 
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Figure 3-2. Syntax for a Logical File 


Logical Files 3-27 











































Logical Files 
Keyword Entries 


The following keywords are valid for logical files: 


ABSVAL 

ACCPTH 

ALL 

ALTSEQ 

CHECK 

CMP 

COLHDG 

COMP 

CONCAT 

DESCEND 

DIGIT 

EDTCDE 

EDTWRD 

FORMAT 

LIFO 

NOALTSEQ 

PFILE 

RANGE 

RENAME 

SIGNED 

TEXT 

UNIQUE 

VALUES 

ZONE 


Note: When a logical file is based on a physical file to be used as a source 
file, you cannot use the following keywords: 

ABSVAL 

ALTSEQ 

DESCEND 

LIFO 

NOALTSEQ 

SIGNED 

UNIQUE 

ZONE 
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ABSVAL 

Use this key field level keyword (absolute values) to specify that when CPF 
sequences the values associated with this numeric field, it is to ignore the sign 
of the field. 


The following example shows six records with zoned decimal key fields: 

Numeric Key Field Hexadecimal 

Record 

(Zoned Decimal) 

Representation 

1 

98 

F9F8 

2 

00 

FOFO 

3 

98- 

F9D8 

4 

97 

F9F7 

5 

20 

F2F0 

6 

99 

F9F9 

If no sequencing keywords are specified, the records are sequenced in this 
order: 

Numeric Key Field Hexadecimal 

Record 

(Zoned Decimal) 

Representation 

2 

00 

FOFO 

5 

20 

F2F0 

3 

98- 

F9D8 

4 

97 

F9F7 

1 

98 

F9F8 

6 

99 

F9F9 

If the ABSVAL keyword is specified, 
used, and the resulting sequence is: 

Numeric Key Field 

the absolute value of the negative field is 

Hexadecimal 

Record 

(Zoned Decimal) 

Representation 

2 

00 

FOFO 

5 

20 

F2F0 

4 

97 

F9F7 

1 

98 

F9F8 

3 

98- 

F9D8 

6 

99 

F9F9 


The ABSVAL keyword is not valid for a field of character data type. You 
cannot use it with the keywords SIGNED, ZONE, or DIGIT. 


Logical Files 
ABSVAL 
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Logical Files 

ACCPTH ABSVAL (a key field level keyword) and ALTSEQ (a file level keyword) are 

mutually exclusive. That is, if you specify ABSVAL for a key field, NGALTSEQ 
is in effect for that key field, even if ALTSEQ was specified at the file level 
(whether the NOALTSEQ keyword is specified or not). 

If you do not specify SIGNED, ABSVAL, ZONE or DIGIT for a key field, the 
value of the field is treated as a string of unsigned binary data. 

The following example shows how to specify the ABSVAL keyword: 
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ACCPTH(data-base-file-name[.llbrary-name]) 

Use this file level keyword (access path) when you want this logical file to 
share the access path with another physical or logical file with a keyed 
sequence access path; the name of the file describing the access path is the 
parameter value for the keyword. 

Use this keyword instead of specifying key fields and select/omit fields for 
each record format In the logical file. When you use this keyword, you can 
reduce the overhead required on the system for maintenance of separate 
access paths. 

The following example shows how to specify the ACCPTH keyword: 
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Logical Files 
ACCPTH 


When an access path is shared, the file describing the access path must not 
already be sharing an access path of another file. That is, there is only one 
level of access path sharing. The following illustrates how access paths cannot 
be shared. 


Describes Access Path: Shares Access Path: 

Physical or Logical File F ■* — ■■■ -- Logical File G - 




Logical File H 


Invalid Sharing of Access Path: 
-— Logical File H 



When files share an access path, the fields in the file sharing the access path 
must follow the same rules that are applied to any field description for a logical 
file. 

The file sharing the access path must specify the same physical files (specified 
using PFILE keywords) as the file describing the access path, and the physical 
files must be specified in the same order on each record format; however, the 
number of record formats or the allocation of physical files to the formats is 
variable. Also, the DTAMBRS parameter for the Create Logical File (CRTLF) 
command can exclude some of the members of the physical files specified on 
the PFILE keyword. The record formats used in the file sharing the access path 
must contain the same key fields and select/omit fields used in the file 
describing the access path. 

The fields in the record formats of the file sharing the access path can be a 
subset of the fields in the file describing the access path, or the record format 
of the file sharing the access path can include more fields from the physical 
file record format than are specified in the file describing the access path. 
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ALL 


Use this select/omit level keyword to specify the action to be taken after all 
other select/omit specifications have been processed for this logical file. 
Specifying ALL with S in position 17 indicates that records not meeting any of 
the other select/omit rules are to be selected. Specifying O in position 17 
indicates that records not meeting any of the other select/omit rules are to be 
omitted. The ALL keyword must be the last select/omit keyword specified. 
You cannot specify a field name with the ALL keyword. 

if the ALL keyword is not specified, the default action taken is the opposite of 
the last select/omit specification that you made for the file. If the last 
specification was a select, the default is to omit ail. if the last specification 
was an omit, the default is to select all. 

The following example shows how to specify the ALL keyword: 
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ALTSEQ(alternate-sequence-table-name[.library-nafine]) 

This file level keyword (alternate sequence) tells CPF that if a key has been 
specified for this file, CPF is to use an alternate collating table when 
sequencing the records of a file member for retrieval. The name of the 
alternate table is a required parameter value; the library name is optional. If the 
library name is not specified, the library list *LIBU is used. 

The ALTSEQ keyword is not valid when FILETYPE(*SRC) is specified on the 
Create Logical File (CRTLF) command. See the CPF Programmer's Guide for 
information about the FILETYPE(*SRC) parameter value. 

Notes: 

1. Alternate collating sequences are not valid for key fields with a data type of 
either packed decimal or binary, or for key fields with SIGNED or ABSVAL 
specified. For those fields, NOALTSEQ (a key field level keyword) is 
assumed and need not be specified. NOALTSEQ can also be specified for 
any field in a composite key not requiring the alternate sequence. 

2. At file creation time, you must have operational rights to the alternate 
collating table. The table is created using the Create Table (CRTTBL) 
command. See the CPF Programmer's Guide for information on how to 
create and enter a table. 

In the following example, records with format RECORDl are sequenced by key 
NAME according to the alternate collating sequence TABLET in library 
TABLELIB: 
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Logical Files 
CHECK 


CHECK(@dit-check-code [. » .]) 

This field level keyword is a validity checking keyword for use in display files. 
CHECK does not request any action by data base data management but can 
be specified in the data base file description so that it can be duplicated into 
display file descriptions when this field is referenced at display file creation. 
The rules for specifying this keyword are the same for a data base record 
format as for a display file record format. See Chapter 4, Display Files, for 
information on how to specify this keyword. 

The following edit/check codes are not allowed in data base files even for 
reference purposes: 

Codes Meanings 

FE Field exit check 

RL Right-to-left cursor movement 

RLTB Right-to-left top-to-bottom cursor movement 
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CMP(relational-operator<code constant-value) 

The CMP keyword is equivalent to the COMP keyword. The COMP keyword is 
preferred because it is compatible with DOS on other systems. See the COMP 
keyword description for an explanation of how to use these keywords. 


Logical Files 
CMP 


COLHDG('line-1' [1ine-2' ['line-31]) 

This field level keyword (column heading) specivies column headings to be used 
as a label for this field by the query utility, the data file utility (DFU), and the 
screen design aid (SDA). 

A maximum of three lines (of 20 characters each) is allowed. 

Each line of the column heading must be enclosed in apostrophes. Use double 
apostrophes (") to specify apostrophes within column headings. One or more 
blanks must bo used to separate the first column heading line from the second 
and the second from the third. 

If COLHDG is not specified, the column heading from the physical file is used 
(except when the field is a concatenation of fields, in which case the default is 
the field name). If COLHDG is specified and TEXT is not, 50 positions of 
column heading information are used as text. For example, COLHDG('Order' 
'Date') is equivalent to TEXT('Order Date'). 

The following example shows how to specify the COLHDG keyword: 
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Logical Files 
COMP 


COIVIP(ralationai-operator-co€ie [value i field-name]) 

At the select/omit level, use this keyword (comparison) to specify that CPF is 
to make a comparison using the value of the field you are defining. CPF 
compares this field with the value of another field within the same record or 
compares this field with a constant value that you specify. The relational 
operator code determines whether the results of the comparison meet the 
criteria for omission/selection. 


At the field level, use this keyword as a validity checking keyword that can be 
specified in a logical file so that it can be duplicated into a display file 
description through the reference function. (See Chapter 4, Display Files, for 
information on how to specify this keyword for validity checking.) 

The valid relational operator codes are: 


Relational 

Operator Code Meaning 


EQ 

NE 

LT 

NL 

GT 

NG 

LE 

GE 


Equal 
Not equal 
Less than 
Not less than 
Greater than 
Not greater than 
Less than or equal 
Greater than or equal 


At the select/omit level, a field name can be specified as a parameter value for 
this keyword. The field name must be specified within the physical file record 
format (that is, not renamed or a concatenated logical name). A field name 
cannot be specified when COMP is used as a validity checking keyword. The 
parameter values must correspond to the data type and the length of the field 
specified. Character parameter values must be enclosed in apostrophes; 
numeric parameter values must not be enclosed in apostrophes. 


Note: If the value specified is a constant and the field named (to be compared 
to) is a numeric field, alignment is based on the decimal precision specified, 
and leading and trailing blanks are filled with zeros. If no decimal point is 
specified, the decimal point is assumed to be to the right of the last (rightmost) 
digit. For example, for a numeric field with a length of 5 (specified in column 
34) and 2 decimal positions (specified in column 37), 1.2 is interpreted as 
001.20, and 100 is interpreted as 100.00. 


The following example shows how to specify the COMP keyword as a 
select/omit keyword: 
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CONCAT(field-1 field-2...) 

Use this field level keyword (concatenate) when you want to combine two or 
more fields from the physical file record format into one field in the logical file 
record format you are describing. The name of this concatenated field must 
appear in positions 19 through 28. Specify the physical file field names in the 
order in which you want them to be concatenated, and separate them by 
blanks. 


Note: The sequence in which the field names are specified in the logical file is 
Important. If the same physical field is specified more than once In a record 
format In the logical file (that Is, by using either RENAME or CONCAT), the 
sequence in which the fields are specified in the logical file is the sequence in 
which the data is moved to the physical file. Thus, the value of the field the 
last time the field is specified in the logical file is the value in the physical 
record. If a renamed (RENAME keyword) or concatenated (CONCAT keyword) 
field is used as a key field, the value of the key for the purposes of ordering 
the record is the value assigned to the first occurrence of the field in the 
logical file record format. 

The following rules and restrictions apply: 


• A field containing decimal positions other than zero cannot be included in a 
concatenated field. A field having decimal positions of zero can be included, 
in which case the field is treated as an integer field. 

• The length of the concatenated field is the sum of the lengths (digits and 
characters) of the fields that are included in the concatenation. 


• Data type is assigned by CPF as follows: 


Fields Being 

Concatenated Concatenated Field 


Numeric (B,S,P) 
Character (A) 
Alphameric 


Zoned decimal (S) 
Character (A) 
Character (A) 


• When concatenating numeric fields, the sign of the rightmost field in the 
concatenation is used as the sign of the concatenation. The signs of the 
other fields are ignored; however, they are present in the concatenation. 
Therefore, if a negative value can appear in a field other than the last, you 
must take appropriate action to eliminate the embedded signs (such as 
converting the concatenated field to packed decimal). 


• The maximum length of a concatenated field varies depending on the data 
type of the concatenated field and the length of the fields being 
concatenated. If the concatenated field is zoned decimal (S), its total length 
cannot exceed 31 bytes; if it is character (A), its total length cannot exceed 
32 766 bytes. 


Logical Files 
CONCAT 


Logical Files 
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The following examples show how to specify the CONCAT keyword: 
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In this example, MTH, DAY, and YEAR are fields in the physical 
file that are concatenated into one field DATE in the logical file. 
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In this example, if the program changes DATE from 01 03 81 to H 
02 05 81, the value placed in the physical record does not n 

change because the fields specified last are MTH (value 01), DAY h 
(value 03), and YEAR (value 81); however, if MTH, DAY, and H 

YEAR are changed to new values, the value of DATE in the k 

physical record also changes. ^ 
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In this example, fields from the physical file are concatenated ^ = i = = i = = i i = ^ 



into more than one field in the logical file. 
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DESCEND 
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DESCEND 


Use this key field level keyword to specify that the values of this character or 
numeric key field are to be retrieved in descending sequence. If this keyword 
is not specified, ascending sequence is assumed. 

The following example shows how to specify the DESCEND keyword: 



DIGIT 


This key field level keyword specifies that only the digit portion (rightmost 4 
bits) of each byte of the key field is to be used when constructing a value 
associated with this key field. The zone portion is filled with zeros. 

This keyword is applied against the entire key field (not just a position within 
the field); it is valid only for character or zoned decimal type fields. 

You cannot use this keyword with the ABSVAL, the SIGNED, or the ZONE 
keyword. 

If you do not specify SIGNED, ABSVAL, ZONE, or DIGIT for a key field, the 
value of the field is treated as a string of unsigned binary data. 


The following example shows how to specify the DIGIT keyword: 
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In this example, if ORDTYP is a 3-byte field, the values of the 
field for three different records could be as follows: 

Values 

Hexadecimal 
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EDTCDECedit-code \ floating-currency-symbol]) 

Use this field level keyword to specify an edit code for editing of output data 
using this current field description. The edit code specification is not used by 
data base data management but is retained in the data base file description so 
it can be duplicated into device file descriptions through the reference function 
at device file creation. An edit code is a required parameter value for this 
keyword. 

EDTCDE is valid for numeric fields only. You cannot specify both the EDTCDE 
and EDTWRD keywords for the same field. You can use the EDTCDE keyword 
to perform edit functions, such as the following: 

• Suppress leading zeros 

• Omit a sign from the low-order position of the field 

• Punctuate the field without having to specify an edit word (see the 
EDTWRD keyword) 

• Perform asterisk fill 

• Specify floating currency symbol 

• Perform user-defined edit functions 

The following example shows how to specify the EDTCDE keyword: 
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CPF Edit Codes: The CPF edit codes that you can specify as a parameter value 
for this keyword are: 

1 through 4 
A through D 
J through M 
X through Z 

See the EDTCDE keyword descriptions in Chapter 4, Display Files, and Chapter 
5, Printer Files, for summaries of the functions provided by all CPF edit codes 
except X. Edit code X is used only to override the default edit codes used in 
query (default edit code is J) and the data file utility (default edit code is L). 


Logical Files 
EDTCDE 


User-Defined Edit Codes: You can also specify any of five user-defined edit 
codes (5 through 9). Before creating a device file from DDS source containing 
user-defined edit codes, the user-defined edit codes must exist. When 
creating the device file, the editing information is extracted from the 
user-defined edit codes as referenced in the DDS. Changing user-defined edit 
codes does not affect existing device files unless the device files are 
re-created. See the CPF Programmer's Guide and the CL Reference Manual for 
a description of how to create user-defined edit codes if those shipped with 
the system cannot be used. 


Asterisk Fill and Floating Currency Symbol: You can specify asterisk fill or 
floating currency symbol with edit codes 1 through 4, A through D, and J 
through M. 

When you specify asterisk fill, an asterisk (*) is written for each zero 
suppressed. A complete field of asterisks is printed for a zero balance field. 

When you specify a floating currency symbol, the symbol appears to the left of 
the first significant digit. The symbol does not print on a zero balance when an 
edit code is used that suppresses the zero balance. The symbol that you 
specify must match the system value for the floating currency symbol 
(QCURSYM) when the file is created; it does not have to match when the file 
is used. See the CPF Programmer's Guide for a description of how to change 
this symbol. 

See the EDTCDE keyword descriptions in Chapter 4, Display Files, and Chapter 
5, Printer Files, for examples of valid edit codes, source data, and edited 
output. 
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EDTWRD(^edit-word') 


If you cannot accomplish the desired editing by using the EDTCDE keyword, 
you can specify an edit word instead. The edit word specification is not used 
by data base data management, but is retained in the data base file description 
so that it can be duplicated into device file descriptions through the reference 
function at device file creation. The edit word specifies the form in which the 
field values are to be displayed and clarifies the data by inserting characters 
directly (such as decimal points, commas, floating and fixed currency symbols, 
and credit balance indicators). EDTWRD can also be used to suppress leading 
zeros and provide asterisk-fill protection. 

The following rules apply when you specify an edit word: 

• The edit word must be enclosed in apostrophes. 

• The EDTWRD keyword is valid for numeric fields only. 

• The number of replaceable characters in the edit word must equal the length 
of the field. 

• When you are using the floating currency symbol, the sum of the number of 
blanks and the stop-zero-suppression character (digit positions) contained in 
the edit word must be equal to the number of positions in the field to be 
edited. The currency symbol is not counted as a digit position. 

For example, if you specify a field length of 7 with 2 decimal positions, the 
edit word must be specified as: 

EDTWRDf b b b b$o. b b') 

where the b represents a blank. 

• Any printable character is valid, but the following characters in certain 
positions have special meanings: 

~ Blank: A blank is replaced with the character from the corresponding 
position of the data field. A blank position is referred to as a digit 
position. 

~ Ampersand: An ampersand causes a blank in the edited field. The 
ampersand is not printed. 

- Zero: A zero stops zero suppression; place it in the rightmost position 
where zero suppression is to stop. The zero is replaced with the 
character from the corresponding position of the data field, unless that 
character is zero. Any zeros in the data that appear to the right of the 
stop-zero-suppression character are printed. At least one leading zero is 
suppressed. Each zero that is suppressed is replaced by a blank. 
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- Asterisk: An asterisk stops zero suppression and replaces zeros with 
asterisks (asterisk protection). Place the asterisk in the rightmost position 
where zero suppression is to stop. Each zero that is suppressed is 
replaced by an asterisk. An asterisk preceding a zero is interpreted as 
representing asterisk protection. In this case, the zero prints as a 
constant. 

An asterisk is considered a digit replace position. 

- Currency Symbol: A currency symbol coded immediately to the left of the 
zero suppression code causes the insertion of a currency symbol in the 
position to the left of the first significant digit. It is called the floating 
currency symbol when used in this manner. 

A currency symbol coded in the leftmost position of the edit word is 
fixed and prints in the same location each time. When used in this 
manner, it is called the fixed currency symbol. 

The currency symbol is not considered a digit replace position. This 
symbol must correspond to the QCURSYM system value. 

- Decimals and Commas: Decimals and commas are printed in the same 
relative positions in which they are coded in the edit word unless they are 
to the left of the first significant digit. In that case, the positions are 
filled in with blanks or replaced by asterisks. 

- All Other Characters: All other characters are printed if they are to the 
right of the significant digits in the data field. If they are to the left of 
the high-order significant digits in the data, these positions are 

filled with blanks or replaced by asterisks if asterisk protection is being 
used. 

• If you want to show a negative sign with a negative number, include a sign 
in the edit word. Use either the minus sign (-) or the letters CR (credit). 
These print only if the number is negative. 

• You cannot specify both the EDTWRD and EDTCDE keywords for the same 
field. 

See the EDTWRD keyword description in Chapter 4, Display Files, for 
examples of edit words, source data and edited output. 

The following example shows how to specify the EDTWRD keyword: 
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FORMATidata-base-file-nameE.library-name]) 


Use this record level keyword to specify that this record format is to share the 
specifications for a previously defined record format. The name of the record 
format you are defining must be the name of the previously defined record 
format. The data base file name is required; it is the name of the physical or 
logical file from which the previously defined record format is taken. The 
library name is optional; if you do not specify it the library list in effect at file 
creation time is used. 

If you specify the FORMAT keyword, you cannot specify field specifications for 
this record format. However, you must specify a key and, if necessary, 
select/omit specifications if you want them to be in effect for this file. 

If the data base file from which you are using the record format is deleted, the 
record format remains in existence as long as some file is using the record 
format. For example, a record format RECORD in FILE2 uses the FORMAT 
keyword to share the specifications of an existing record format RECORD in 
FILE1. Both files have been created. If FILE1 is deleted and then re-created 
with different DDS, RECORD still exists in FILE2 and can itself be referenced 
for the original record format by other files using the FORMAT keyword. 

The following example shows how to specify the FORMAT keyword: 
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The record format for this physical file is the same as the 
previously specified record format in file CUSMSTL. The 
name of this record format (CUSREC) must be the same as 
the name of the record format in CUSMSTL. 
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Use this file level keyword to specify that if records with duplicate key values 
are retrieved from one based-on physical file member, they are to be retrieved 
in a last-in-first-out (LIFO) order. 

If neither LIFO nor UNIQUE is specified, records that have duplicate key values 
are retrieved In a first-in-first-out (FIFO) order. 

The following example shows how to specify the LIFO keyword: 
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The LIFO keyword is not valid when FILETYPE(*SRC) is specified on the Create 
Logical File (CRTLF) command. See the CPF Programmer’s Guide for 
information about the FILETYPE(*SRC) parameter value. 


IMOALTSEQ 


Use this key field level keyword to specify that the ALTSEQ keyword specified 
at the file level Is not to apply to this key field. If you specify ABSVAL or 
SIGNED for a key field, NOALTSEQ is in effect whether or not the NOALTSEQ 
keyword is specified for that key field. 


The following example shows how to specify the NOALTSEQ keyword: 
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PFiLE(physical-file-name[.library-name][.32]) 

Use this record level keyword to identify the physical file(s) containing the data 
to be accessed through the record format you are now defining. The PFILE 
keyword is required on every record format in a logical file. Up to 32 physical 
file names can be specified on PFILE keywords in a logical file. If the 
maximum is being used, 32 physical file names can be specified on one record 
format (using one PFILE keyword) or 32 physical file names can be distributed 
among 32 record formats; or, file names can be unevenly distributed among 
record formats. In any case, the maximum number of physical file names 
allowed is 32. 

For each physical file name, a library name is optional. If the library name is 
omitted, the library list at file creation time is used. 

If more than one physical file name is specified for one record format in the 
logical file, ail fields in the record format for the logical file must exist in all 
physical files specified. If your program requires access to fields that occur in 
one or more of the based-on physical files, but not In ail of them, you can 
specify a separate logical file record format that includes those fields. For 
instance, if FLD1 and FLD2 occur in physical files PF1, PF2, and PF3, but FLD3 
occurs only in PF3, you cannot specify FLD3 in a logical file record format 
based on PF1 and PF2. To provide access to FLD3, specify a second logical 
file record format that includes FLD3. This means that you cannot use a logical 
file to bring together into one record format fields from separate physical files. 

A record read through the use of a record format in a logical file can contain 
data from only one physical file, and a record written through the use of a 
record format in a logical file can be stored only In one physical file. 

If this logical file shares an access path defined by another physical or logical 
file (the ACCPTH keyword is specified for this file), then the physical files 
specified with the PFILE keywords in this file must be the same as the physical 
file specified on the other file, and they must be specified in the same order. 

Members of physical files can be specified on the DTAMBRS parameter on the 
Create Logical File (CRTLF) or Add Logical File Member (ADDLFM) commands. 
All such physical files must be specified on the PFILE keyword at file creation 
time; otherwise, the commands do not complete successfully. 
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The following examples show how to specify the PFILE keyword: 


Logical Files 
PFILE 
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L0GRCD4, L0GRCD5, and L0GRCD6 can have unique fields. 


L0GRCD6 specifies a qualified physical-file name. 
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Logical Files 
RANGE 


RANGEdow high) 


At the select/omit level, use this keyword to specify a range of values that are 
used to determine which records from the associated physical file are to be 
selected or omitted for the logical file. Specify the lower limit first, followed by 
one or more blanks, and then the higher limit. 

At the field level, use this keyword as a validity checking keyword for display 
files. In this case, RANGE is not used by data base data management. It is 
specified in the logical file description so that it can be duplicated into display 
file descriptions when this field is referenced at display file creation. (See 
Chapter 4, Display Files.) 

Note: If the value specified is a constant and the field named (to be compared 
with) is a numeric field, alignment is based on the decimal precision specified, 
and the leading and trailing blanks are filled with zeros. If no decimal point is 
specified, the decimal point is assumed to be to the right of the last (rightmost) 
digit. For example, for a numeric field with a length of 5 (specified in column 
34) and 2 decimal positions (specified in column 37), 1.2 is interpreted as 
001.20, and 100 is interpreted as 100.00. 

The following example shows how to specify the RANGE keyword: 
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RENAME(physical-file-field-name) 


Logical Files 
RENAME 


Use this field level keyword when you want a field name in the logical record 
format you are defining to be different from its corresponding physical file field 
name. The name as it appears in the physical file record format is the 
parameter value for this keyword. One field in the physical file record format 
can be renamed to more than one field in the record format being described. 

The following are three situations in which you might want to rename fields: 

• Programs were written using a different name for the same field. 

• You want to map one field in a physical file record format to two or more 
fields in a logical file record format. 

• You are using a language that does not permit two fields having different 
names to have only one data storage area. (RPG III is such a language.) By 
specifying the RENAME keyword, you allow both fields to access the same 
data storage area. 

Note: The sequence in which the field names are specified in the logical file is 
important. If the same physcial field is specified more than once in a record 
format in the logical file (that is, by using either RENAME or CONCAT), the 
sequence in which the fields are specified in the logical file is the sequence in 
which the data is moved to the physical file. Thus, the value of the field the 
last time the field is specified in the logical file is the value in the physical 
record. If a renamed (RENAME keyword) or concatenated (CONCAT keyword) 
field is used as a key field, the value of the key for the purposes of ordering 
the record is the value assigned to the first occurrence of the field in the 
logical file record format. 

The following example shows how to specify the RENAME keyword: 
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Logical Files 
SIGNED 


SIGNED 

This key field level keyword specifies that when sequencing the values 
associated with this numeric key field, CPF is to consider the signs.of the 
values (negative versus positive values). 

This keyword is not valid for a field of character data type. You cannot use it 
with the ABSVAL, the ZONE, or the DIGIT keyword. 

SIGNED (a key field level keyword) and ALTSEQ (a file level keyword) are 
mutually exclusive. If you specify SIGNED for a key field, NOALTSEQ is in 
effect for that key field even if ALTSEQ was specified at the file level (whether 
or not the NOALTSEQ keyword is specified). 

If you do not specify SIGNED, ABSVAL, ZONE, or DIGIT for a key field, the 
value of the key is treated as a string of unsigned binary data. 

The following example shows how to specify the SIGNED keyword: 
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Logical Files 
TEXT 


Use this record or field level keyword to supply a text description. The 
description must be enclosed in apostrophes, with a maximum of 50 
characters. If more than 50 characters are specified, the keyword is accepted; 
however, the excess characters are dropped and a warning message is issued. 

The following example shows how to specify the TEXT keyword: 



If TEXT is not specified and the COLHDG keyword is specified, 50 positions of 
column heading information are used as a default for TEXT. 

if COLHDG is not specified and the field is not concatenated, the text is taken 
from the physical field text if it exists. If COLHDG is not specified and the 
field is concatenated, there is no text. 

Note: You can specify TEXT at both the record format level and the field level. 
Both TEXT and FORMAT cannot be specified at the record format level (the 
format already contains text). 
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Logical Files 
UNIQUE 


UNIQUE 


Use this keyword at the file level to specify that records with duplicate key 
values are not allowed within a member of this logical file. Any inserts or 
additions of new records, or updates to existing records, that would result in a 
duplicate key are rejected. The application program issuing the write or the 
update operation receives a message. When a work station user is using DFU, 
a message is displayed at the work station. A copy file command copying 
records that would have duplicate keys in this file cannot be completed. 

When the UNIQUE keyword is specified for a logical file, records in any of the 
based-on physical files cannot have duplicate key values if the duplicate key 
values occur because of keys specified in the logical file. Also, when the 
UNIQUE keyword is specified for a logical file, the IVIAINT(*IMMED) parameter 
value must be specified on the Create Logical File (CRTLF) command that 
creates the file. This means that the access path is maintained immediately as 
changes are made. See the CPF Programmer's Guide for a description of the 
[\/IAINT{*IMMED) parameter value. 

If the UNIQUE keyword is not specified, records with duplicate key values are 
sequenced In first^in-first-out (FIFO) order, unless the LIFO keyword is 
specified. In which case they are sequenced in last-in-first-out order. For an 
explanation of how records with duplicate key values are sequenced when 
those records are not in the same file member, see the section on data base 
records in the CPF Programmer's Guide. 

The following example shows how to specify the UNIQUE keyword: 
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VALUES(value-1 [value-2...[value-20]]) 


Logical Files 
VALUES 


Use this keyword at the select/omit level to specify a list of up to 20 values. 
The values are used to determine which records from the associated physical 
file are selected or omitted for this logical file. If a select/omit field key value 
is equal to one of the values, the record containing that value is selected or 
omitted. 

You can also use this keyword at the field level as a validity checking keyword 
for display files. Specify this keyword on a field not within a select/omit 
specification, in this case, VALUES is not used by data base data 
management. Instead, it is retained so that it can be duplicated into display file 
descriptions through the reference function at display file creation. (See 
Chapter 4, Display Files.) 

Note: If the value specified is a constant and the field named (to be compared 
with) is a numeric field, alignment is based on the decimal precision specified, 
and the leading and trailing blanks are filled with zeros. If no decimal point is 
specified, the decimal point is assumed to be to the right of the last (rightmost) 
digit. For example, for a numeric field with a length of 5 (specified in column 
34) and 2 decimal positions (specified in column 37), 1.2 is interpreted as 
001.20, and 100 is interpreted as 100.00. 

The following example shows how to specify the VALUES keyword: 
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Logical Files 
ZONE 


ZOI^E 

Use this key field level keyword to specify that only the zone portion (leftmost 
4 bits) of each byte of the key field is to be used when constructing a value to 
be associated with this key field. The digit portion is filled with zeros. 

This keyword is applied against the entire key field (not just a position within 
the field) and it is valid only for character or zoned decimal type fields. 

You cannot use ZONE with the ABSVAL, the SIGNED, or the DIGIT keyword. 

If you do not specify SIGNED, ABSVAL, ZONE, or DIGIT for a key field, the 
value of the field is treated as a string of unsigned binary data. 

The following example shows how to specify the ZONE keyword: 
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Chapter 4. Display Files 


This chapter is divided into two sections. The first Positional Entries, provides 
rules and examples for filling in positions 1 through 44 of the Data Description 
Specifications form. 

The second section of this chapter. Keyword Entries, provides rules and 
examples for specifying DDS keywords. The keywords are described in 
alphabetical order. 

For guidance in choosing positional entries and keywords for display files, see 
the CPF Programmer's Guide, 


DEFINING A DISPLAY FILE 


To define a display file, specify the entries in the following order: 


1. File level entries (optional) 

2. Record level entries 

3. Field level entries (optional) 


) Repeat these entries for each 
record format in the file. 


Specify at least one record format in the file. The maximum number of record 
formats in a display file is 1024. The maximum number of fields in any one 
record format is 32 767. The maximum combined length of all named fields 
and indicators in a record format is 32 767, regardless of usage (I, O, B, M, H). 


Note: The file name is specified through the Create Display File (CRTDSPF) 
command, not through DDS. 

Complete display file examples can be found in Appendix F, Examples. 

An explanation of file level, record level, and field level can be found in Chapter 
1, Introduction. 


The syntax rules for specifying DDS keywords can be found in Chapter 1, 
Introduction. 
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Figure 4-1. Display File Coding Example 


4-2 


4 




Positional Entries (Positions 1-44) 


Display Files 
Positions 1-5 


This section describes how to specify the first 44 positions of the Data 
Description Specifications form for display files. To code the rest of the form, 
see the section Keyword Entries (Functions Field, Positions 45-80) in this 
chapter. 

Figure 4-1 shows some positional entries for display files. 


Positions 1-5 (Sequence Number) 

Use these positions to specify a sequence number for each line on the form. 
The sequence number is optional and is used for documentation purposes only. 


Position 6 (Form Type) 

The A in this position designates this as a Data Description Specifications 
form. The form type is optional and is for documentation purposes only. 


Position 7 (Comment) 

An asterisk (*) in position 7 identifies the line as a comment line. Comment 
lines can appear anywhere in DDS and are retained only in the source file and 
printed on the source listing. (Comments are not printed on the expanded 
source listing.) Use positions 8 through 80 for comment text. A blank line (no 
characters specified in positions 7 through 80) is treated as a comment line. 


Positions 7-16 (Conditioning) 


Option Indicators 

Positions 7 through 16 are a multiple field area in which you can specify option 
indicators. Option indicators are 2-digit numbers from 01 to 99. Your program 
can set option indicators on (hex FI) or off (hex FO) to select a field or 
keyword. 

A condition is an ANDed grouping of two through nine indicators that must all be in 
effect (set off if N is specified; set on if N is not specified) before the field or 
keyword is selected. You can specify a maximum of nine indicators for each 
condition and nine conditions for each field or keyword; therefore, a maximum 
of 81 indicators can be specified for each field or keyword, when nine 
indicators are used with nine conditions. 


Display Files 
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Display Files 
Positions 7-16 


4-4 . 


When you specify a condition so that more than one indicator must be on or 
off before the condition is satisfied, it Is called an AND condition; the first 
indicator you specified, AND the second, AND the third, and so on, must ail be 
in effect before the condition is satisfied and the field or the keyword is 
selected. The field or the keyword must be specified on the same line as the 
last (or only) set of indicators specified. 

You can also specify several conditions for a field or keyword so that if any 
one of them is satisfied, the field or the keyword is selected. This is called an 
OR relationship, and it means that if the first condition is satisfied, OR the 
second condition, OR the third condition, and so on, the field or the keyword is 
to be selected. Note that conditions within the OR relationship can consist of 
just one indicator or can consist of several indicators ANDed together. 
Indicators can be ANDed to form a condition; conditions can be ORed to give 
your program several ways to select the field or keyword. 


AND (Position 7): If you need more than three indicators to form an ANDed 
condition, specify them on the next line or lines. You can specify an A in 
position 7 on the second or following lines to continue the ANDed condition, or 
you can leave it blank because A is the default. 


OR (Position 7): If you specify several conditions that are to be ORed together, 
each condition must start on a new line and each condition except the first 
must have an 0 in position 7. An O specified for the first condition produces a 
warning message, and that position is assumed to be blank. 


NOT (Positions 8, 11, 14): If you want an Indicator to be off instead of on to 
satisfy a condition, specify an N In the position just preceding the indicator 
(position 8, 11, or 14). 


I Conditioning More than One Fieid or Keyword: If you are conditioning a field, 
the field name (or the constant) and the last (or only) indicator must be on the 
same line. If the field is not selected for an output operation, no keywords 
specified for that field are in effect, regardless of how the keywords are 
conditioned. For example, in Figure 4-1, FLDA is selected if either indicator 01 
is off or indicator 02 is on. If FLDA is not selected, any keyword associated 
with that field, such as DSPATR(HI), is ignored. 

If you want to condition one or more keywords, the last (or only) indicator 
must appear on the same line as the keywords. If the conditioning applies to 
keywords on more than one line, keyword continuation must be used for the 
indicators to apply to all keywords. See Data Description Specifications Syntax 
Rules \n Chapter 1, Introduction. 
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Screen Size Condition Names 


Display Files 
Positions 7-16 


If you want your program to open this file to display devices with screen sizes 
other than 24 lines by 80 characters, you must specify the DSPSIZ keyword at 
the file level. You can then condition the use of keywords and the location of 
fields with the screen size condition names specified for the DSPSIZ keyword. 
If you do not specify the DSPSIZ keyword, your program can only open this 
file to display devices with a 24 by 80 screen. 

The following table shows the screen size condition name for each display 
device: 


Device 

Screen Size 

Screen Size 
Condition Name 

System Console 

16 lines by 64 characters 
(1024 characters) 

*DS1 

5251 (Models 1 and 2) 

5252 

12 lines by 80 characters 
(960 characters) 

*DS2 

5251 (Models 11 and 12) 

24 lines by 80 characters 
(1920 characters) 

*DS3 

Note: You can specify a user-defined screen size condition name instead of 
*DS1, *DS2, or *DS3. For an explanation of how to specify user-defined 
condition names, see the DSPSIZ keyword description. 
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Display Files 

Positions 7-16 The following example shows how to specify the DSPSIZ keyword and screen 

size condition names: 
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In this example, the screen size condition name for the primary screen 
size is defined as ^LARGE Q, and the screen size condition name for 
the secondary screen size is defined as *C0N Q. FIELDA appears on 
line 1, position 2 for both screen sizes. FIELDB appears on line 1, 
position 65 for the primary screen size (*LARGE by default), and on 
line 1, position 49 for the secondary screen size (*C0N specified in 
positions 9 through 16). FIELDC appears on line 17, position 1 for the 
primary screen size and on line 15, position 1 for the secondary screen 
size. Note that only secondary screen sizes (in this example *C0N) can 
be used to condition field locations. 
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You use these screen size condition names in a way similar to that of option 
indicators, except that screen size condition names do not appear in your 
program and do not appear in the output record. A screen size condition name 
is on if the display file is opened to the corresponding display size. When you 
use screen size condition names, the following rules apply: 

• Specify the DSPSIZ keyword to designate the primary screen size and any 
secondary screen sizes. If the DSPSIZ keyword is not specified, the default 
is DSPSIZ(*DS3). 

• You can specify only one screen size condition name for a condition. (AND 
or an OR with other screen size condition names or option indicators is not 
permitted.) 

• The screen size condition name must start in position 9. 

• The screen size condition name can be user-defined. See the DSPSIZ 
keyword description for more details. 

• You can specify N in position 8 to designate a NOT condition (for the 
primary screen size). Note that this implies an OR relationship between the 
remaining screen size condition names (for example, N*DS1 implies *DS2 or 
*DS3 when *DS2 and *DS3 are specified as secondary screen sizes on the 
DSPSIZ keyword). 

• You must not use screen size condition names so that the line or position 
sequence of a field within a record is altered. Fields are ordered in the 
display file by primary locations; should any secondary location alter this 
primary sequence, a severe error occurs at file creation time. 

For example, FLD1 and FLD2 are on the primary screen located on line 2, 
position 2 and line 4, position 2, respectively. It is invalid to use a screen 
size condition name to display FLD2 ahead of FLD1 on the screen (on line 
1) for a secondary screen size. 

• When you specify the location of a field on a secondary screen size, you can 
only specify positions 8 through 16 (conditioning) and 39 through 44 
(location). 

• If you do not specify a condition name for a keyword for which condition 
names are valid, the primary condition name specified on the DSPSIZ 
keyword is the default. 
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Figure 4-2 shows the valid and invalid combinations of screen size condition 
names and primary screen sizes, when all screen sizes have been specified on 
the DSPSIZ keyword and the first one specified varies. 


Screen Size 

Condition 

Name^ 

Primary Screen Size 

16 by 64 
DSPSIZ(*DS1...) 

or 

DSPSIZ(16 64...) 

12 by 80 
DSPSIZ(*DS2...) 

or 

DSPSIZ(12 80...) 

24 by 80 
DSPSIZ(*DS3...) 

or 

DSPSIZ(24 80...) 

*DS1 

ERRORS 

VALID 

VALID 

*DS2 

VALID 

ERROR2 

VALID 

*DS3 

VALID 

VALID 

ERROR2 

N*DS1 

VALID 

ERRORS 

ERRORS 

N*DS2 

ERRORS 

VALID 

ERRORS 

N*DS3 

ERRORS 

ERRORS 

VALID 


^See the DSPSIZ keyword description for providing user-defined names for these screen size 
condition names. 

^These screen size condition names are in error because that screen size is the primary screen 
size. 

^These screen size condition names are in error because a primary and a secondary location are 
implied for the same screen size. A condition name specified with the NOT condition implies 
an OR relationship. For example, N*DS1 implies *DS2 *DS3. 


Figure 4-2. Valid Screen Size Condition Specifications 
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The following two examples show screen size conditioning for a keyword; 
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In the first example, the screen size condition name *DS2 is specified, so that 
the message line is line 10 for a 12 by 80 screen and line 24 (the default) for a 
24 by 80 screen. In the second example, the message line is also line 10 for 
the 12 by 80 screen and line 24 for the 24 by 80 screen, even though no 
screen size condition name was specified, because the primary screen size 
(*DS2) specified with the DSPSIZ keyword is the default. 
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Position 17 (Name Type) 

The value in this position identifies the type of name specified in positions 19 
through 28 (name). The valid entries for display files are: 


Entry 

Meaning 

R 

Record format name 

Blank 

Field name 


Position 18 (Reserved) 

This position does not apply to any file and must be blank unless an asterisk 
appears in position 7 (indicates a comment line). 
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Positions 19-28 (Name) 
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Use these positions to specify record format names and field names. The 
following rules apply: 

• Names must be 10 characters or less. 

• Names must start in position 19. 

• Names must begin with an alphabetic character (A through Z, $, and #). 

All subsequent characters can be alphameric (A through Z, 0 through 9, @, 
$, #, and underscore (_)). There can be no embedded blanks. 

Figure 4-1 shows how to specify record format names and field names. 

High-level languages can impose specific length and value restrictions on 
names. For example, RPG III accepts only field names of 6 characters or less 
and record format names of 8 characters or less, and they cannot contain an 
underscore. It is your responsibility to ensure that the names used here are 
acceptable to all language processors that process the file. 


Record Format Name: When you specify R in position 17 (name type), the 
name specified in positions 19 through 28 is a record format name. You can 
specify more than one record format for a display file, but each record format 
name must be unique within that file. 


Field Name: When position 17 (name type) is left blank, the name specified in 
positions 19 through 28 is a field name. Field names must be unique within 
the record format. 
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Constant Fields: Constant fields are unnamed fields (positions 19 through 28 
must be blank). Further, the following rules apply to constant fields: 

• Position 17 through 38 must be blank. 

• The location of the field is required (positions 39 through 44). 

• The field can be conditioned using option indicators (positions 7 through 
16). 

• Secondary screen locations can be specified using screen size condition 
names (positions 8 through 16). Only the screen size condition name and 
location can be specified; that is, positions 7, 17 through 38, and 45 
through 80 must be blank. 

• The constant itself is defined in positions 45 through 80 using one of the 
following entries: 

- Explicit DFT keyword (specify the literal within apostrophes with the DFT 
keyword) 

- Implicit DFT keyword (specify the literal within apostrophes without the 
DFT keyword) 

- DATE keyword (specify no literal; see the DATE keyword description) 

- TIME keyword (specify no literal; see the TIME keyword description) 

• The EDTCDE or EDTWRD keyword can be specified only when DATE or 
TIME is also specified. 


How to Determine the Order of Fields in a Record Format: The order in which 
you specify named fields in a record format is the order in which they appear 
in your program when it is compiled. (Unnamed fields do not appear in your 
program.) 

The order in which named and unnamed fields appear in the actual display is 
determined by the locations you specify in positions 39 through 44. See 
Positions 39-44 (Location) later in this chapter. Hidden fields (H in position 38) 
do not appear on the display. 
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Position 29 (Reference) 

Specify R In this position to use the reference function of CPF to copy the 
attributes of a previously defined named field (called the referenced field) to the 
field you are defining. The referenced field can be previously defined In the 
display file you are defining; or it can be in a previously created data base file 
(the data base file to be referenced is specified with the REF or REFFLD 
keyword). The attributes referenced are the length, data type, and decimal 
positions of the field, as well as editing, validity checking, and text keywords. 

If you do not specify R, you cannot use the reference function for this field and 
you must specify field attributes for this field. 

Position 29 must be blank at the file and record levels. 

The name of the referenced field can be either the same as the field you are 
defining or different from the field you are defining. If it is the same, you need 
only specify R in position 29 (in addition to specifying the name of the field 
you are defining in positions 19 through 28). If it is different, you must specify 
the name of the referenced field with the REFFLD keyword. 

You can specify the name of the file defining the referenced field as a 
parameter value with the REF or the REFFLD keyword. See REF and REFFLD 
keyword descriptions later in this chapter and Appendix A, How to Specify REF 
and REFFLD, for explanations of how CPF finds the referenced field. 

You do not need to copy all attributes from the previously defined field to the 
field you are defining. To override specific attributes of the referenced field, 
specify those attributes for the field you are defining as follows: 

• To override editing keywords (EDTCDE or EDTWRD), specify EDTCDE or 
EDTWRD for the field you are defining. (You can simply delete these 
keywords by specifying DLTEDT for the field you are defining.) 

• To override validity checking keywords (CHECK, COMP, RANGE, VALUES), 
specify any validity checking keyword for the field you are defining. (You 
can simply delete these keywords by specifying DLTCHK for the field you 
are defining.) 
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When you override some specifications, others are also affected, as follows: 

• If you specify keyboard shift attribute, field length, or decimal positions for 
the field you are defining, neither editing nor validity checking keywords are 
copied from the referenced field. 

• If you override the previously defined data type to character (by specifying 
A, X, or W in position 35), decimal positions are not copied; however, if you 
specify N or I in position 35 and leave blanks in positions 36 through 37 
(decimal positions), the field you are defining has the decimal positions of 
the referenced field. 

• Packed decimal and binary fields are not supported for display files; 
therefore, when you reference fields of these types, the data type assigned 
is zoned decimal with a keyboard shift as follows: 

- If editing is in effect for the field you are defining, the keyboard shift is 
numeric only (Y in position 35). 

- If no editing is in effect for the field you are defining, the keyboard shift 
Is signed numeric only (S in position 35). 

Note: Once the display file is created, the referenced file can be deleted or 
changed without affecting the field definitions In the display file. To 
incorporate changes made in the referenced file, delete and re-create the 
display file. 
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Positions 30-34 (Length) 

You must specify a length for each named field unless the length is being 
copied from a referenced field. The length is the number of bytes of data to 
be passed to or received from your program when I/O operations are done for 
the field. This is called the program length of the field. 

The length of a field when It appears on the display is called the display length; 
it is greater than or equal to the program length. The display length of a field 
Is determined by the keyboard shift (specified in position 35) and other field 
specifications such as decimal positions (positions 36 through 37) and editing 
functions. (See Position 35 (Data Type/Keyboard Shift) for more information.) 

The display length does not include beginning and ending attribute characters 
of a field; however, these characters must be considered when planning the 
display layout for field locations. Within a record, the ending attribute character 
of a field can overlap the beginning attribute character of the next field, 
requiring only one space between fields. See Positions 39 through 44 
(Location) for more information. 

The maximum length of a character field is equal to the display size minus two. 
(This allows space for the beginning and ending attribute characters.) The 
maximum length of a numeric (zoned decimal) field is 31 positions. 

A field length must not be specified for a constant field. See the DATE, DFT, 
or TIME keyword descriptions for explanations of the lengths of constant 
fields. 

When you specify the length of a field, the entry must be right-justified; 
leading zeros are optional. 
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The following example shows valid and invalid field length specifications: 



Invalid Length Specification 


Valid Length Specification 


If you are using a referenced field, you can override the length of the field by 
specifying a new value or by specifying the increase or decrease in length. To 
increase the length, specify +n, where n is the increase. To decrease the 
length, specify -n, where n is the decrease. For example, an entry of +4 for a 
numeric field indicates that it is to be 4 digits longer than the referenced field. 

A field cannot occupy the first or the last position on the display. These 
positions are reserved for attribute characters. For example, on a 24 by 80 
screen, an entry of 5 In positions 30 through 34 (length), 24 in positions 39 
through 41 (line), and 75 in positions 42 through 44 (position) is invalid for a 
signed numeric field. The display length is 6, causing the field to end in 
position 80 (the sign position). This does not allow room for the ending 
attribute character. 
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Position 35 (Data Type/Keyboard Shift) 
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For display files, the entry you make in position 35 is the keyboard shift 
attribute. This entry does not determine the data type of the field used in your 
program. The entry in positions 36 through 37 (decimal positions) determines 
the internal data type of the field. 


The keyboard shift attribute automatically shifts 5250 work stations with 
data-entry keyboards and, for all keyboards, can limit what the work station 
user can key into a field. However, It does not shift 5250 work stations with 
the typewriter-like keyboard or the system console. Also, it does not restrict In 
any way what your program can write to a field. Your program can write 
alphabetic characters to a numeric field and, in most cases, read that field and 
receive those characters. Any restrictions are enforced solely by the 
programming language used for your program. 

The following are valid entries for display files: 


Entry Meaning 


Data Type Permitted 


Blank 

X 

A 

N 

S 

Y 

W 

I 


Default 

Alphabetic only 
Alphameric shift 
Numeric shift 
Signed numeric 
Numeric only 
Katakana (for Japan only) 
Inhibit keyboard entry 


Character 

Character 

Character or numeric 

Numeric 

Numeric 

Character 

Character or numeric 


Figures 4-1 and 4-3 show how to specify the keyboard shift attribute. 


The following sections describe the keyboard shift attributes in detail. 


Default (blank): If you leave position 35 blank, the entry In positions 36 
through 37 (decimal positions) determines the internal data type of the field as 
follows: 

• If you make a valid entry in positions 36 through 37, the data type is zoned 
decimal and the keyboard shift attribute is signed numeric (S). This is not 
true if you also specify an editing keyword; in that case, the keyboard shift 
attribute is numeric only (Y). 

• If you make no entry in positions 36 through 37, the data type is character 
and the keyboard shift attribute Is alphameric shift (A). 

If a referenced field is defined as packed or binary, it Is converted to zoned 
decimal in the display file. Conversion to or from packed or binary can occur 
within your program. 


Display Files 
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Alphabetic Only (X): Both types of keyboards are in lowershift. Only the 
characters A through Z, comma (,), period (.), dash (-), and space ( ) can be 
keyed in. When lowercase characters a through z are keyed in, uppercase 
characters are sent to the program. (See the CHECK(LC) keyword description 
for an explanation of how to permit keying in of lowercase characters for the 
typewriter-1 ike keyboard on the 5250 work station.) 

Alphameric Shift (A): Both types of keyboards are in lowershift. All characters 
are valid for entry. 

Numeric Shift (N): Each type of keyboard is shifted to allow numeric entry; 
uppershift for the data-entry keyboard and lowershift for the typewriter-like 
keyboard. All characters are valid for entry. 

The display length for a numeric shift field is one more than the length coded 
in positions 30 through 34 when the following conditions occur: 

• The field is an unedited, input-capable field. 

• The value in the decimal positions field is greater than zero. 

The extra position In the display length is for the decimal point. 

Note: Input numeric shift fields that have decimal positions specified (In 
positions 36 and 37) are processed by data management as numeric-only 
fields, except that editing is not supported. For more information, see the 
keyboard shift attribute Numeric Only (Y), described later in this section. 


Signed Numeric (S): The data-entry keyboard is in lowershift; the 
typewriter-like keyboard is in uppershift. Only the numbers 0 through 9 can be 
keyed into the field (no blanks, no plus sign, no minus sign). To leave the field, 
press the Field Exit key, the Field + key, the Field - key, a cursor movement 
key, or the Enter/Rec Adv key. 

When choosing between signed numeric and numeric only, you should 
consider these differences: 

• Signed numeric restricts the characters that can be keyed into the field to 
the numbers 0 through 9. 

• Signed numeric does not permit EDTCDE or EDTWRD keywords. 

• Numeric only performs character removal to remove nonnumeric characters; 
signed numeric prevents the work station user from keying In these 
characters at all. 
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The display length for the field is one more than the length specified in 
positions 30 through 34. The rightmost position on the screen is reserved for a 
minus sign. 

When CPF passes the contents of the field to your program, the following 
considerations apply: 

• Your program always sees a numeric, right-adjusted, zero-filled field. 

• The field is displayed as a right-adjusted, blank-filled field (unless 
CHECK(RZ) is specified, in which case it is displayed as right-adjusted, 
zero-filled). 

• CPF does not perform decimal alignment. 

• CPF does not remove characters from the field (as it does for numeric only 
fields). 

When an input-capable signed numeric field is displayed and CHECK(RZ) is 
not specified, CPF performs zero suppression by default (the EDTCDE and 
EDTWRD keywords are not valid for signed numeric fields). 

Negative numbers are handled as follows: 

• On input, the work station user must key in the number and press the Field 
- key. The number is right-adjusted in the displayed field with a minus sign 
in the rightmost position. CPF converts the rightmost significant digit to hex 
Dn, where n is the significant digit, before passing the number to your 
program. For example, if the work station user keys in 12345 and presses 
the Field - key, 12345- is displayed and your program sees F1F2F3F4D5. 

• On output, CPF converts hex D in the rightmost digit to hex F (thus 
changing the negative number to a positive number for display purposes) 
and displays a minus sign in the rightmost (additional) position in the 
displayed field. For example, if your program sees FI F2F3F4D5, it appears 
on the display as 12345-. 

On the system console, a signed numeric field is treated as a numeric-only 
field. 

For examples of signed numeric fields, and sample data keyed into them, see 
Figure 4-3 and the table following it later in this section. 
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Numeric Only (Y): Each keyboard Is shifted to allow numeric entry: uppershift 
for the data-entry keyboard and lowershift for the typewriter-like keyboard. 
Only the numbers 0 through 9, plus {+), minus (-K period (.), comma {,), and 
space ( ) can be keyed into the field. To leave the field, any key can be 
pressed. 

The display length for a numeric-only field is one more than the program, 
length (the length specified in positions 30 through 34) when both of the 
following conditions occur: 

• The field is an unedited, input-capable field. 

• The value in positions 36 through 37 (decimal positions) is greater than zero. 

The extra position In the display length is for the decimal point. 

When CPF passes the contents of the field to your program, the following 
considerations apply: 

• Your program sees a numeric, decimally aligned field. 

• To enter digits to the right of the decimal, positions 36 through 37 (decimal 
positions) must be greater than zero and the work station user must key in 
the decimal character. 

• The work station user cannot key In the maximum number of digits, a 
decimal character, and a sign character, because the display length of the 
field equals only the program length plus one. (The work station user can 
avoid keying a sign character by pressing the Field + key or the Field - key.) 

• CPF removes all characters except 0 through 9 (whether keyed or supplied 
through the EDTWRD keyword) and the sign. 

• CPF converts embedded blanks (hex 40) to zeros (hex FO) before decimal 
alignment. (Embedded blanks are blanks between any significant digits in 
the field; leading blanks, trailing blanks, zeros, plus, and minus are not 
treated as significant digits. Note that embedded ampersands in an edit 
word are also converted to zeros before decimal alignment.) 

• All nonnumeric characters are removed before decimal alignment and validity 
checking. (If you specify the EDTWRD keyword and it supplies additional 
numeric characters (0 through 9), they are not removed.) 

• The field length in the input buffer is the program length. 

When CPF displays a numeric-only field, the EDTCDE or the EDTWRD 
keyword. If specified, applies (EDTCDE and EDTWRD can be specified only for 
numeric-only fields). The display length equals the program length plus the 
editing characters from the specified edit code or edit word. 
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Negative numbers are handled as follows: 

• On input the work station user can enter a negative number in one of two 
ways: 

- Key in the digits, then a minus. The minus sign (-) appears (hex 60) on 
the display where it was keyed in. 

- Key in the digits, then press the Field - key. If CHECK(RZ) or 
CHECK(RB) is not specified, a bracket (]) is displayed in the rightmost 
position. This causes an error message to be displayed at the work 
station if decimal positions other than zero are specified in positions 36 
through 37. If CHECK(RZ) or CHECK(RB) is specified, the keyed in digits 
are right-adjusted. No minus sign is displayed in either case. 

When a negative number is passed to your program, CPF converts the 
rightmost significant digit from hex Fn (positive) to hex Dn (negative), 
where n is the significant digit. 

• On output, the sign appears in the rightmost display position, taking up one 
of the positions in the display length. See EDTCDE and EDTWRD keyword 
descriptions in this chapter. 

Note: CPF examines each character of a numeric-only field to remove 
nonnumeric characters (plus sign (+), minus sign (-), comma (,), and decimal 
point(.)) and nonsignificant digits, and to convert embedded blanks to zeros. 
This can delay response time if a significant number of these fields must be 
processed on an input operation. 

Katakana (W): This field attribute designates the Japanese Katakana keyboard 
shift. All characters are valid for entry. 


Inhibit Keyboard Entry (I): A field with this keyboard shift attribute does not 
accept data keyed in from the keyboard, and an error is issued if any keys are 
pressed. The work station user can press the field advance key (( ^ 


or 


) to position the cursor at the start of the field. This field can be used 
to allow input from feature devices such as the Magnetic Stripe Pieader or the 
Selector Light Pen. The Field +, Field Exit, and Dup keys are valid for a field 
with this attribute, and they function the same as if pressed in any input field 
for which DSPATR(PR) is not in effect. 


The display length for an inhibit keyboard entry field is one position greater 
than the length coded in positions 30 through 34 when the following 
conditions occur: 


• The field is an unedited, input-capable field. 

• The value in the decimal positions field is greater than zero. 

The extra position in the display length is for the decimal point. 

Figure 4-3 and the table following it show how data keyed in by the work 
station user is passed to your program. 


Display Files 

Position 35 


Display Files 


4-21 




Display Files 
Position 35 


IBM International Butinasi Machines Corporation DATA DESCRIPTION SPECIFICATIONS 


File 

Keying 

Instruction 

Graphic 








Programmer j Date 

Key 









GX21-7754-1 UM/060* 
Printed in U.SA 


Description 


Page of 




Conditioning 

^ Name Type (B/R/K/S/0) 

Name 

19 20 21 22 23 24 25 26 27 28 

<0 Reference (R) 

Length 

30 31 32 33 34 

g Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

i| 

11 
36 37 

1 

z 

i 

§ 

5 

D 

38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 76 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 s 

& 

i2r 

E 

£ 

6 

$ 

< 

1 

1 

d 

1 

7 

Z 

o 

z 

d 

Condition Name 

8 

1 

9 10 

z 

1 

11 

^ Indicator 

! 

i 

14 

1 
1 
15 16 

Line 

39 40 41 

Pos 

42 43 44 

wjwgR 

g 




J 





n 

T 

mn 






N M 




; i 


bh 

■ 

■ 

1 

■ 


1 

1 

mim 

g 



JR 

i 


1^ 

G1 



iliiliKI 

iS 

ES 


UTES 




: ; 










aSESE 

g 





_ 






wasM 




M m5 



a 

■g 

w 

HH 

■ 

■ 

1 

■ 

1— ———— 

1 

■ 


g 





1 

■ 

1 








i : ^ ^ 



0 


ms 

am 

iSi 


11 






g 











wimm 




^ ■ m5 



Q 

mn 

H 


I? 

fl^ 

il 

- 1 ICll IICI II# StI li 1 L 






a&EEE 

g 




_ 







WSISlil 




M Ma 

a 


0 

■a 








(Alphabetic onlyj 




g 















IIHIg 

1 

■Rrn 

H 

am 






4 





u 

■ j r% ■ j 


g 











mmm 




8 

1 

m 

E 








n 

"^loiQricQ nun(i6ric| i ■ i i • i i ■ j j ? ! ! 




g 












iiafii&n 

1 





mm 

n 

Wi 

Q 

K 

am 

■■ 

■ 

■ 

WM 

■ 

n 


■ 

1 


g 












ISgOtgl 

■ 







Q 

m 

D 

tm 

am 






4 

(Numeric only( 




g 



■ 

1 

■ 

■ 

1 






1 






5 

Q 

m 

Ji 

tm 

am 


Hli 




. i !■ r 

A ■ • 1 

ISSSSL 

□ 





: 








1 






5 

BJ 

m 

a 

am 

WBFi 






4 

'-t-H 




gWEBSl 

g 





■ 

1 

1 












5 



IS 








} 

-r-H Hidden field 1 




g 

Q 



— 

- 

- 

- 


- 

- 

- 

— 


- 

- 

- 

- 

— 



- 


1 

■ 

-r— 


■ 

■ 

■ 

■ 

n 



■ 

■b 


1 



III 

g 



■ 

1 

■ 

1 

■ 

— 

—■ 


— 




— 

— 

>— 

h 


1 

B 

■ 

1 



H 

m 

■ 

■ 



■ 

BH 





g 



■ 

■ 

1 

1 

1 











h- 

— 



■ 

i i 

M 

n 

■ 

■ 

n 


■ 

HHI 





g 





■ 

■ 

■ 





IM 

■ 

1 

■ 

1 

1 

1 

HHI 

■ 

■ 

1 

— 

BHI 

T 

■ 

■ 









g 







" 





IHHHI 

1 

1 

1 

1 

1 

1 

IHHI 

1 

■ 

1 

HH 

HH 

■ 

■ 

■ 



■ 

HB 

■■■■■■■■■■■■—MB— 



■■■■ 

g 



■ 

■ 

■ 

1 

1 

1 

1 

1 

II 

inm 

1 

1 

1 

1 

1 

1 

■■■ 

1 

■ 

1 

Bi 

■H 

n 

■ 

■ 

II 


II 

BH 





'Number of sheets per pad may vary slightly 


Figure 4-3. Data Type and Keyboard Shift Coding Example 
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In the following table, three special characters are used: 

• The_means that no character was entered by the work station user. 

• The b indicates a blank. 

• The ] is represented internally as hex DO. 

Except where indicated (for instance, the fourth entry under SIGN1, which the 
user enters by pressing the Field Exit key), the user enters the data only by 
pressing a command function key. (This table refers to fields defined in Figure 
4-3.) 


Field Name 

As Keyed in by the 

As Passed to 

(Keyboard Shift) 

Work Station User 

Your Program 

CHARA 

1. 

b b b b b (hex 


2. A B C _ 

A B c b b 


3. A _ C_ 

A be b b 


4._D E 

b bbD E 

CHARB 

1. 

b bb bb 

(Alphameric Shift) 

2. ABC_ 

b b A B c 


3. A _ C_ 

b b A b c 


4._D E 

b b b D E 

CHARC 

1. 

0 0 0 0 0 

(Alphameric Shift) 

2. ABC_ 

0 0 A B C 


3. A _ C_ 

0 0 A b c 


4._D E 

0 0 0 D E 

CHARD 

1. 

b bb b b 

(Alphabetic Only) 

2. ABC_ 

A B C b b 


3. 4_ 

error message 


4. A B C $ _ 

error message 
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Field Name 

As Keyed in by the 

As Passed to 


(Keyboard Shift) 

Work Station User 

Your Program 


SIGN1 

1. 

00000 


(Signed Numeric) 

2. 1 2 3_ 

0 0 12 3 



3. 1 _ 3_ 

4. _4 5 _ 

(Field Exit key) 

5. _4 5 _ 

(Field + key) 

6. _4 5 _ 

00 103 

00045 

0004 5 

0 0 0 4 N (hex F0F0F0F4D5) 


SIGN2 

(Field - key) 

7. 1 2 3 4 5 _ 

1. 

1 234 5 

00000 


(Signed Numeric) 

2. 1 2 3 4 _ 

0 12 3 4 



3. 1 2_ 

4. 1 2_ 

(Field - key) 

0 0 0 1 2 

000 1 K (hex F0F0F0F1D2) 
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Field Name As Keyed in by the 

(Keyboard Shift) Work Station User 


As Passed to 
Your Program 
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NBR1 

1. 






(Numeric Only) 

2. 

0 

0 

0 

0 

5 


3. 

0 

0 

0 

5 



4. 

0 

0 

2 

— 

— 

NBR2 

1. 






(Numeric Only) 

2. 

0 

0 

0 

0 

5 _ 


3. 

0 

0 

5 




4. 

5 






5. 

0 

5 

0 

0 



6. 

5 

b 

5 




7. 

5 

b 

b 




8. 5 5. 1_ 

9. 5 0 0 0 . _ 

10. 5 0 0 0 0 

11. 5 5 -_ 

12 . 5 _ - -_ 

13. 5 _ + _ - 


00000 
0 0 0 0 5 
0000 5 
0 0 0 0 2 

0 0 0 0 0 
0 0 5 0 0 
0 0 5 0 0 
0 0 5 0 0 
50000 
5 0 5 0 0 
0 0 5 0 0 
0 5 5 1 0 

error message (too many digits) 

error message (too many decimal positions) 

0 5 5 0 ] 

0 0 5 0] 

0 0 5 0] 


NBR3 Input processing is the same as for NBR2. 

(Numeric Only) 


NBR4 

(Numeric Shift) 


1 ._ 

2. 5 -_ 

3. _ 5 _ -_ 

4. 5 _ +_ 

5. 5 _ A B C _ 

6. 5 _ K K_ 

7. 5 _ K A K _ 

8. 5 _ K K A _ 


00000 
0 0 5 0] 

0 0 5 0] 

0 0 5 0 0 
0 0 5 0 0 
5 0 2 0 ] 

5 0 2 0 ] See Note. 
0 0 5 0 0 See Note. 


NBRZ This is a hidden field and does not appear on the screen. 

(Hidden Field) 


Note: The internal representation of K is hex D2. All nonnumeric 
characters (including these with hex D in the higher-order position) 

are deleted with no place value. For example, 5_KAK_becomes 

5020]. 
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Keyboard Types 


There are two keyboards on System/38: a typewriter-like keyboard and a 
data-entry keyboard. The system console has the typewriter-like keyboard; the 
5250 work station can have either the typewriter-like or the data-entry 
keyboard. 


Typewriter-Like Keyboard: The typewriter-like keyboard functions in either 
uppershift or lowershift. When in uppershift, the upper symbol (for the keys 
that have two symbols) is entered. When in lowershift the lower symbol (for 
the keys that have two symbols) is entered. For alphabetic keys (which have 
only one symbol), uppercase characters are entered when the keyboard is in 
uppershift. On the 5250 work station, uppercase alphabetic characters are also 
entered when the keyboard is in lowershift unless the CHECK(LC) keyword is 
specified. If the CHECK(LC) keyword is specified, and the work station user 
places (or leaves) the keyboard in lowershift lowercase a through z characters 
can be entered. On the system console, lowercase characters are entered as 
lowercase; data management translates the entire field to uppercase. Note that 
none of the keyboard shift attributes causes an automatic uppershift for the 
typewriter-like keyboard. 

The following shows the typewriter-like keyboard: 
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Data-Entry Keytx)ard: The data-entry keyboard functions in either numeric shift 
(upper) or alphabetic shift (lower). 

When the keyboard is in uppershift the upper symbol (for the keys that have 
two symbols) is entered. On this keyboard, the numbers 0 through 9 are the 
upper symbols on alphabetic keys. When the keyboard is in lowershift, the 
lower symbol (for the keys that have two symbols) is entered. The alphabetic 
characters A through Z are the lower symbols and are always in uppercase. 

The data-entry keyboard does not support lowercase characters a through z, 
even if the CHECK(LC) keyword is specified. 

The following shows the data-entry keyboard: 
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Note that you enter the numbers 0 through 9 by using the lowershift on the 
typewriter-1 ike keyboard and by using the uppershift (numeric) on the 
data-entry keyboard. Therefore, when a field has one of the numeric keyboard 
shift attributes (numeric shift or numeric only), it causes the typewriter-like 
keyboard to be in lowershift and the data-entry keyboard to be in uppershift. 

In both cases, it allows the entry of numeric characters without having to press 
a shift key. 
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Positions 36>37 (Decimal Positions) 


Use these positions to specify the decimal placement within a zoned decimal 
field and also to specify the data type of the field as it appears in your 
program. 

If you leave these positions blank, CPF assigns a data type of character for the 
field. If you enter a number in these positions, CPF assigns a data type of 
zoned decimal for the field. The number specified is the number of positions 
to the right of the decimal point; the entry must be less than or equal to the 
field length, with a maximum of 31 positions. 

If you are using a referenced field, you can override or change these positions. 
To override decimal positions, specify the new value. To change decimal 
positions, specify the amount you want the field increased or decreased and 
precede It with either a plus (+) or minus (-) sign, respectively. For example, 
an entry of +4 indicates that there are to be four more digits to the 
right of the decimal point than were In the referenced field. 

Figure 4-3 shows how to specify the decimal positions field. 


Position 38 (Usage) 


Use this field to specify that a named field Is to be an output-only, input-only, 
output/input (both), hidden, or message field. No entry should be made in this 
position for a constant (unnamed) field. The valid entries for usage and their 
meanings are: 

Entry Meaning 


Blank or O 
I 

B 

H 

M 


Output only 
Input only 
Output/input (both) 

Hidden (special output/input field) 
Message (special output field) 


Note: Input-only and output/input fields are input-capable fields. Output-only 
and output/input fields are output-capable fields. 


Blank or 0: If you leave the position blank, output only is the default. 


Input Only or Output/Input: All Input-capable (I or B) fields are underlined by 
default. Use the CHGINPDFT keyword or condition the DSPATR (UL) keyword 
to prevent underlining. See the CPF Programmer's Guide for information 
concerning input-capable field limitations for specific devices. 
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Hidden: A hidden field is a named, numeric or alphameric field that does not Position 38 

appear on the display. Your program can send data to the field with an output 

operation, and it can retrieve data from the field with an input operation, but 

the work station user cannot see or change the contents of the field. The 

following rules apply to hidden fields: 

• Hidden fields are always named. 

• Locations are not valid for hidden fields. 

• Specify length, data type, and decimal positions as you would for other 
named fields. 

• You can specify more than one hidden field for a display file. 

Since hidden fields are not displayed, they are not considered input-capable or 
output-capable fields, even though your program can send and receive data 
from them. 

Hidden fields are useful in applications involving subfiles. For example, a 
subfile record can contain record key information in a hidden field. The hidden 
field cannot be seen by the work station user, but is returned to the program 
with the subfile record so that the program can return the record to the data 
base. 


Display Files 
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Message: A message field is a named, output-only, character field. 

The following rules apply to message fields: 

• You can choose with option indicators the selection of message fields, but 
during execution, only one message can be displayed at a time: The 
message from the first message field selected is displayed, and all others 
are ignored for that operation. 

• When a message field is displayed, all other fields you have specified for 
that record are processed in the normal manner. If a 5250 work station is 
being used, the device goes into an error state (locked keyboard, blinking 
cursor, and message displayed with the high intensity (HI) display attribute). 
When the work station user presses the Reset key, normal processing 
continues. 

• The text of the message is established when your program moves a value to 
the message field. 

• The location of the message on the display is the message line (the last line 
on the display unless the MSG LOG keyword is in effect). 

• The length you specify for the message field should be less than 64 
positions for the system console and less than 79 positions for the 5250 
work station. Any message text that occupies more than 63 positions on 
the system console or more than 78 positions on the 5250 work station is 
truncated to fit the message line. 

• The Help key is not supported for message fields; if it is pressed, an 
error message is displayed, indicating that no second-level text is available. 

• The following keywords are valid for a message field: 

INDTXT 

REFFLD 

TEXT 

• You cannot specify M in position 38 for a field if the field is part of the 
subfile record format. 

Note: It is valid to issue an input operation to a record that contains no 

input-capable fields. This permits pressing a command key as a response to 

an output record. 
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Positions 39-44 (Location) 
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Positions 39-44 


Use these positions to specify the exact location on the display where each 
field begins (not valid for hidden or message fields). The validity of these 
entries is based on the DSPSIZ keyword and the screen size condition names. 
See the DSPSIZ keyword description later In this chapter for specific examples. 


Positions 39-41 (Line): Use these positions to specify the line on which the 
field begins; the entry must be right-justified; leading zeros are optional. The 
maximum number of lines is 24 or 12 for the 5250 work stations and 16 for 
the system console. 


Positions 42-44 (Position): Use these positions to specify the starting position 
of the field within the line you specified; it must be right-justified; leading 
zeros are optional. The maximum rightmost position is 80 for the 5250 work 
station and 64 for the system console, unless the line specified in positions 39 
through 41 is the last line on the screen. When the last line of the screen is 
specified, the maximum rightmost position is 79 for the 5250 work station and 
63 for the system console (the last screen position must be available for an 
ending attribute character). 

For fields other than the first field within the record, you can specify the 
location by specifying an increment (+n) for positions 42 through 44 (position). 
The increment indicates the number of spaces to be left between the end of 
the previous field and the start of the field you are defining. An increment of 
plus zero is not valid. 


Beginning Attribute Character: Each field displayed has one attribute character 
that defines the display attribute of the field on the screen. This attribute 
character is not displayed, but occupies one position on the screen immediately 
preceding the field. Because of the beginning attribute character, you cannot 
specify that a field is to begin in the first position of the screen (line 1, position 
1 ). 

When a field begins in position 1 of any line other than line 1, the beginning 
attribute character occupies the last position of the preceding line. If such a 
field is the first field of a record, the preceding line is a part of the record area 
and displays as a blank line. Any record format using that line cannot be 
displayed at the same time as the other record. The last one to be displayed 
causes the other one to be erased (unless CLRL(*NO) is specified for the last 
displayed record). 
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Positions 39-44 Ending Attribute Character: The end of a field on the display Is indicated by an 

ending attribute character, unless there is only one space between that field 
and the next field. In that case, the beginning attribute character of the second 
field serves as the ending attribute character of the first field. In any case, 
there must always be at least one space left between fields in a record. When 
the last position occupied by a field of a record is the last position in a line, 
the ending attribute character for the field is in position 1 of the next line. 
However, the next line is not considered part of the first record, and records 
can be displayed on both lines at once. 

Note that the last screen position must be available for an ending attribute 
character. 

Any field that extends beyond the end of a line on the screen is continued on 
the next line; however, a field cannot extend past the last line on the screen. 


Overlapping Fields: Within a record format, you can describe fields to overlap 
portions of other fields or their attribute characters; however, only one of 
those fields is displayed on the screen at a time. At execution time, when 
processing overlapping fields within a record, CPF looks at the fields in row 
and position sequence. When CPF finds a field whose conditioning is satisfied 
or that does not have an option indicator specified. It selects that field for 
display and ignores the rest of the overlapping fields. Note that the first 
overlapping field that does not have an option Indicator specified always stops 
the search, and any subsequent overlapping fields are never displayed. In the 
following example, if indicator 01 is set on, field 1 is the only field displayed. 

If indicator 01 Is off and indicator 02 is on, field 2 is the only field displayed. 
Field 3 is always displayed when neither of the others is selected. 
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Positions 39-44 


If used incorrectly, this capability can result in problems in user and program 
interface. In the following example, only one input field (FIELD4) is specified 
for the record, and according to the field location specification, this field 
overlaps a preceding output field. The work station user is not able to enter 
any data because FIELD1 is always the field selected for display; the other 
three fields, including FIELD4, are never displayed. 
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Display Length: The display length is increased for certain types of fields and 
must be considered when laying out the display. The display length is 
increased by CPF in the following situations: 

• For numeric-only fields with editing, the display length is determined from 
the edit word or the program length and the edit code. 

• For signed numeric fields, the display length is one more than the program 
length (5250 work stations only). 

• The display length is one more than the program length for numeric shift 
fields and for numeric-only fields without editing when these fields are 
input-capable and have decimal positions greater than zero. 

For an unsigned numeric field (like FIELD4 in the preceding example) with a 
nonzero decimal position, the system requires a decimal character to be keyed 
into the field when decimal values are keyed in as data. In the previous 
example, 123 in FIELD4 does not require a decimal character, but 1234 does 
(123.4). For this field, the display length is 6. 
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Keyword Entries (Positions 45-80) 


This section contains keyword entries valid for defining display files. They are 
entered in positions 45 through 80 (functions). See the section Data 
Description Specifications Syntax in Chapter 1 for a discussion of the general 
rules for specifying keywords. Figure 4-4 shows how to use the general 
syntax rules for specifying DDS for display files. 


International Business Macbines Corporation 


DATA DESCRIPTION SPECIFICATIONS 


GX21-7754-1 UM/050* 
Printed in U.S.A. 


Keying 

Instruction 
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You can specify option indicators and 
screen size condition names in the 
boxed-in positions. 


Figure 4-4. Syntax for a Display File 
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The following keywords are valid for display files. 


Display Files 

Keyword Entries 


ALARM 

LOWER 

SFLLIN 

ASSUME 

MDTOFF 

SFLMSG 

AUTO 

MSGLOC 

SFLMSGID 

BLANKS 

OPENPRT 

SFLMSGKEY 

BLINK 

OVERLAY 

SFLMSGRCD 

BLKFOLD 

OVRATR 

SFLNXTCHG 

CAnn 

OVRDTA 

SFLPAG 

CFnn 

PASSRCD 

SFLPGMQ 

CHANGE 

PRINT 

SFLRCDNBR 

CHECK 

PROTECT 

SFLRNA 

CHGINPDFT 1 

1 PUTOVR 

SFLROLVAL 

CLEAR 

PUTRETAIN 

SFLSIZ 

CLRL 

RANGE 

1 SLNO 

CMP 

REF 

TEXT 

COMP 

REFFLD 

TIME 

CSRLOC 

ROLLDOWN 

UNLOCK 

DATE 

ROLLUP 

USRDFN 

DFT 

RTGAID 

VALUES 

DLTCHK 

RTGCON 

VLDCMDKEY 

DLTEDT 

RTGDEV 


DSPATR 

RTGDEVCLS 


DSPSIZ 

RTG FIRST 


DUP 

RTGFLD 


EDTCDE 

RTGFMT 


EDTWRD 

RTGPOS 


ERASE 

RTNDTA 


ERASEINP 

SETOF 


ERRMSG 

SETOFF 


ERRMSGID 

SFL 


GETRETAIN 

SFLCLR 


HELP 

SFLCTL 


HOME 

SFLDLT 


INDTXT 

SFLDROP 


INZRCD 

SFLDSP 


KEEP 

SFLDSPCTL 


LOCK 

SFLEND 


LOGINP 

SFLENTER 


LOGOUT 

SFLINZ 
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ALARM 


ALARM 


Use this record level keyword to specify that CPF is to activate the audible 
alarm when this record is displayed. For the 5250 work station, the alarm is of 
short duration. For the system console, the alarm remains on until a record 
that does not have this keyword specified is displayed. 

Option indicators are valid with this keyword. 


The following example shows how to specify the ALARM keyword: 
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ASSUME 


Display Files 

ASSUME 


Use this record level keyword to specify that CPF is to assume that this record 
is already displayed on the screen when this file is opened. Such a record 
would also be defined, with the KEEP keyword, in another display file; that 
other display file would be closed before this file (in which you are specifying 
ASSUME) is opened. See the CPF Programmer's Guide for information on 
passing display data between programs. 

Specify the ASSUME keyword for at least one record format within the display 
file so that CPF does not erase the display when the file is opened. In 
addition, specify the OVERLAY keyword with the ASSUME keyword to prevent 
CPF from erasing the display when your program issues the first output 
operation after opening the file. 

If you use the ASSUME keyword, at least one field in the record must be able 
to be displayed. If more than one record with the ASSUME keyword exists, 
they must occupy unique screen lines. 

For CPF to process the data correctly, your program must specify the record 
format name containing this keyword. 

The ASSUME keyword is not needed if the record format you are defining is in 
a shared file (SHARE(*YES) parameter specified on the Create Display File 
(CRTDSPF), Change Display File (CHGDSPF), or Override with Display File 
(OVRDSPF) command). 

This keyword cannot be specified with the USRDFN or the SFL (subfile record) 
keyword. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the ASSUME keyword: 
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AUTO 


AUTO(RA [RAB | RAZ]) 
AUTOiRAB I RAZ) 


The AUTO keyword is equivalent to the CHECK keyword as follows: 

AUTO(RA) CHECK(ER) 

AUTO(RAB) CHECK{RB) 

AUTO(RAZ) CHECK<RZ) 

The CHECK keyword is preferred because it is compatible with DOS on other 
systems. See Keyboard Control in the CHECK keyword description for an 
explanation of how to use these keywords. 
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BLANKS(response indicator ['text']) 

Use this field level keyword on a numeric, input-capable field to enable your 
program to distinguish between zero and all blanks on an input operation. 
When the field contains all blanks, the response indicator is set on. See the 
example later in this keyword description. 

This keyword is also valid for character fields. 

The response indicator associated with the BLANKS keyword should be unique 
within the record. That is, the same response indicator should not be used 
with other keywords such as CHANGE, DUP, or VLDCMDKEY; with any of the 
keywords for command keys; or with the BLANKS keyword in other fields in 
the same record. This is because CPF always turns the response indicator off 
if the field contains nonblank characters on an input operation. CPF does this 
to make sure that when the field appears as all blanks, the response indicator 
is set on, and that when it does not appear as all blanks, the response 
indicator is set off. 

The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 

Option indicators are not valid with this keyword. 


Display Files 
BLANKS 
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BLANKS 


The following example shows how to specify the BLANKS keyword: 
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BLINK 


Display Files 
BLINK 


Use this record level keyvyord to specify that as long as the record being 
defined is displayed, the cursor is to blink. The blinking is set off by the next 
output operation of a record that does not have the BLINK keyword specified. 
This keyword is valid for the 5250 work station only; It is ignored for the 
system console. 

The BLINK keyword is ignored at execution time if ALWBLN(*NO) is specified 
on the Create Device Description (CRTDEVD) or Change Device Description 
(CHGDEVD) command. See the CL Reference Manual for information on how 
to use these commands. 

Option indicators are valid with this keyword. 

The following example shows how to specify the BLINK keyword: 
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BLKFOLD 


BLKFOLD 


Use this field level keyword (blank fold) for named, output-only fields (but not 
message fields) that are defined so that they overflow onto subsequent display 
lines. This keyword causes folding to occur at a blank in the data rather than 
at the end of the display line. It is used to make long text fields easier to read. 
The default is for the data to be folded at the end of the physical line. 

When this keyword is used, the field length is not increased; therefore, it is 
possible for a portion of the output data to be truncated. 

Option indicators are not valid with this keyword. 


The following example shows how to specify the BLKFOLD keyword: 
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CAnn[(response-indicator ['text'])] 

Use this file or record level keyword to specify that the command key specified 
in the keyword (CA01 through CA24) is available for use. It is to be used as a 
command attention (CA) key; no input data is transmitted from the device. 
Response indicators 01 through 99 are valid. 

If you specify this keyword and the work station user presses the specified 
command key, the following happens: 

• All other command key response indicators in the input buffer are set off 
(hex FO). 

• The response indicator, if specified with the CAnn keyword, is set on (hex 
FI). 

• The CPF data management feedback area (including the routing area) is 
updated. 

• Data already in the input buffer remains unchanged except that the response 
indicator (if specified) is set on. 

• Control is returned to your program. 

If you specify a response indicator and the key is pressed, the response 
indicator is set on and returned to your program. (The text information is 
associated with the indicator and is used by high-level language compilers to 
aid in program documentation.) 

If the work station user presses a command key and you have not specified it 
as either a function key (CF) or an attention key (CA), CPF displays a message 
to the work station user indicating that the key is not valid at that time. 

You can use combinations of CA and CF keywords within the same display 
file, but you cannot specify the same key number as both CA and CF. For 
example, CA02 and CF02 are not valid in the same display file. 

Note: File level CA and CF keys are propagated to the record level. This must 
be considered when assigning key numbers. For example, if CA02 is specified 
at file level and CF02 is specified at record level, CF02 is an error. 

If you specify a key in the range 1 through 9, you must supply the leading zero 
in the keyword (for example, CA04). 

Option indicators are valid with this keyword. 


Display Files 
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Validity Checking Considerations: When the work station user presses a CF key, 
the data from fields with their MDTs set on is placed into the input buffer 
before validity checking is done. Any errors in the data are then detected, and 
the appropriate error messages are sent to the display. Because validity 
checking is not done until after the data is placed in the input buffer, pressing 
a valid CA key after the CF key can cause invalid data to be returned to your 
program. This condition is not a problem as long as your program does not 
process the input data when the CA key is pressed. 

This problem can be prevented in either of two ways: 

1. Do not allow the use of CA keys. Specify CF keys, which cause validity 
checking to be done on the data. 

2. Do not specify any of the following validity checking keywords if CA keys 
are allowed: 

CHECK(MIO) 

CHECK(M11) 

CHECK(VN) 

COMP (EQ, NE, LT, NL, GT, NG, LE, GE) 

RANGE 

VALUES 
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Command Keys Valid at Execution Time: As a general rule, the last output 
operation determines which command keys are valid. However, the following 
are exceptions to this rule: 

• When an operation sends no data to the display screen, the validity of 
various command keys is not changed. Such operations include: 

- An output operation to a subfile record 

- An update to a subfile record 

- An output operation to a subfile control record that only clears, deletes, 
or initializes a subfile without displaying the subfile or the subfile control 
record 

• An output operation that displays an error message by selecting ERRMSG or 
ERRMSGID can also select a CA or CF key to be valid while the error 
message is displayed. 

• If SFLDROP is specified for subfile, the validity of the CA or CF key 
specified for the SFLDROP keyword is determined by the last output 
operation. However, as long as the subfile is displayed, the CA or CF key, 
when valid, acts only as a Drop key. 

If two subfiles with SFLDROP in effect are displayed, only the last 
SFLDROP keyword to be displayed is in effect and it affects both subfiles. 

• If two subfiles with SFLENTER in effect are displayed, only the last 
SFLENTER keyword to be displayed is in effect. The cursor position at the 
time the key is pressed determines which subfile is affected. 

Notes: 

1. The following keywords function like command attention keys: 

CLEAR 

HOME 

PRINT (with response indicator specified) 

HELP 

2. CA24 and the Print key are the same on the system console. If both the 
PRINT and CA24 keywords are specified, pressing CA24 at the system 
console prints the display and does not perform the functions specified with 
the CA24 keyword. 


Display Filas 
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CFnn[(re8pon8o-inclicator ['text'])] 


Die’iay 

CFnn 


Use this file or record level keyword to specify that the command key specified 
in the keyword (CF01 through CF24) is available for use. It is to be used as a 
function (CF) key to transmit modified data as opposed to an attention key 
(CA), which does not transmit modified data. Response indicators 01 through 
99 are valid. 

If you specify this keyword, and the work station user presses the specified 
command key, the following happens: 

• All other command key response indicators in the input buffer are set off 
(hex FO). 

• The response indicator, if specified with the CFnn keyword, is set on (hex 
FI). 

• The CPF data management feedback area (including the routing area) is 
updated. 

• Data is placed in the input buffer according to data received from the 
device. 

• Control is returned to your program. 

If you specify a response indicator and the key is pressed, the response 
indicator is set on and returned to your program along with the input data. If 
no response indicator is specified, the input data is returned to your program. 
(The text information is associated with the indicator and is used by high-level 
language compilers to aid in program documentation.) 

If the work station user presses a command key and you have not specified it 
as either a function key (CF) or an attention key (CA), CPF displays a message 
to the work station user indicating that the key is not valid at that time. 

You can use combinations of CF and CA keywords within the same display 
file, but you cannot specify the same key number as both CA and CF. For 
example, CA01 and CF01 are not valid in the same display file. 

Note: File level CA and CF keys are propagated to the record level. This must 
be considered when assigning key numbers. For example, if CA02 is specified 
at file level and CF02 is specified at record level, CF02 is an error 

If you specify a key in the range 1 through 9, you must supply the leading zero 
in the keyword (for example, CF03). 

Option indicators are valid with this keyword. 
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CFnn I Command Keys Valid at Execution Time: As a general rule, the last output 

operation determines which command keys are valid. The following are 
exceptions to this rule: 

• When an operation sends no data to the screen, the validity of the various 
command keys is not changed. Such operations include: 

- An output operation to a subfile record 

- An update to a subfile record 

- An output operation to a subfile control record that only clears, deletes, 
or initializes a subfile without displaying the subfile or the subfile control 
record 

• An output operation that displays an error message by selecting ERRMSG or 
ERRMSGID can also select a CA or OF key to be valid while the error 
message is displayed. 

• If SFLDROP is specified for a subfile, the validity of the CA or the CF key 
specified for the SFLDROP keyword is determined by the last output 
operation. However, as long as the subfile is displayed, the CA or CF key, 
when valid, acts only as a Drop key. 

If two subfiles with SFLDROP in effect are displayed, only the last 
SFLDROP keyword to be displayed is in effect and it affects both subfiles. 

If two subfiles with SFLENTER in effect are displayed, only the last SFLENTER 
keyword to be displayed is in effect. The cursor position at the time the key is 
pressed determines which subfile is affected. 

Notes: 

1. The following keywords function like command function keys: 

ROLLUP 

ROLLDOWN 

2. CF24 and the Print key are the same key on the console. If both the PRINT 
and CF24 keywords are specified, pressing CF24 at the console prints the 
display and does not perform the functions specified with the CF24 
keyword. 
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The following example shows how to specify the CFnn keyword 
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CHANGE(respoii 30 -indicdtor ['text']) 

Use this record or field level keyword to set on the specified response indicator 
for an input operation under the following conditions: 

• The keyword is specified at the record level, and any input-capable field in 
the record format has Its modified data tag (MDT) set on. 

• The keyword is specified for an input-capable field, and that field has its 
modified data tag (MDT) set on. 

The MDT of an input-capable field is set on when the work station user keys 
into the field or when your program selects the DSPATR(MDT) keyword for the 
output operation that displays the field. If the MDT is set on using the 
DSPATR(MDT) keyword, the data in the field may not have changed even 
though the MDT (and hence the response Indicator specified for CHANGE) is 
set on. Also, note that the MDT is set on even if the work station user rekeys 
the same data in the field as was initially displayed (such as keying into a blank 
field and then blanking the field). 

Note: The CHANGE response indicator is not set on when a command 
attention key (CA, Help, Print, Home, or Clear) is pressed. 

When CPF detects validity checking errors and redisplays the record with an 
error message, any CHANGE keyword response indicators that have been set 
on by keying into fields remain on until all validity checks succeed and the 
record is passed to your program. 

The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 

Option indicators are hot valid for this keyword. 
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CHECK 


CHECK(validity-checking-code [. . .]) 
CHECKCkeyboard-control-code [. . .]) 
CHECK(cursor-control-code) 



The CHECK keyword can perform the following functions, depending on the 
parameter values specified: 


Function Valid Parameter Values 


Validity checking 
Keyboard control 
Cursor control 


AB, ME, MF, M10, M11, VN 
ER, FE, LC, RB, RZ 
RL, RLTB 


The following CHECK keywords provide compatibility with other systems: 


. CHECK(ER) is equivalent to AUTO(RA) 

. CHECK(LC) is equivalent to LOWER 
. CHECK(RB) is equivalent to AUTO(RAB) 

. CHECK(RZ) is equivalent to AUTO(RAZ) 

Option indicators are valid only for CHECK(ER) and CHECK(ME). If specified 
on a subfile record format, option indicators are valid for these keywords only 
if the value specified for SFLPAG equals the value specified for SFLSIZ (see 
the SFLPAG keyword description). 

See the following sections for explanations of the CHECK keyword functions. 


Validity Checking 

Use CHECK at the field level to specify that CPF or the device is to check the 
validity of the data entered into an input-capable (input-only or output/input) 
field. 


CHECK validates the data by applying one or more edit/check algorithms 
against the data. An error message is displayed if a specified edit/check 
algorithm is not satisfied. The valid edit/check codes are: 


Edit/ 


Check 


Code 

Meaning 

AB 

Allow blanks 

ME 

Mandatory enter 

MF 

Mandatory fill 

MIO 

IBM Modulus 10 self-check 

M11 

IBM Modulus 11 self-check 

VN 

Validate name 


algorithm 

algorithm 
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(AB) Allow Blanks: Use this code at the file, record, or field level to allow 
all-blank input to satisfy validity checking for an input-capable field should any 
associated validity check fail. This enables the passing of data to the program 
when the work station user has positioned the cursor to the field but left it 
blank (for instance, by pressing the Erase Input key, the Field Exit key, or the 
Spacebar). For example, FLD1 is an input-capable field with CHECK(M10 ME) 
in effect. If the work station user accidentally keys into the field, the M10 
algorithm must be satisfied. Specifying (CHECK(M10 ME AB) allows the work 
station user to blank the field to satisfy validity checking. 

When specified at the file level, this keyword is effective for all input-capable 
fields in the file for which a validity checking keyword is coded. Likewise, 
when specified at the record level, this keyword is effective for all 
input-capable fields in the record for which a validity checking keyword is 
coded. At the field level, this keyword should always be specified with another 
validity checking keyword (CHECK(M10, M11, VN), COMP, RANGE, VALUES). 

CHECK(AB) cannot be used with option indicators and should not be specified 
if SFLROLVAL or SFLRCDNBR is also specified for the field. 

CHECK(AB) can be used in data base files for reference purposes. 

When you consider using CHECK(AB) with other validity checking functions, 
note that processing occurs in the following order: 

1. Any of the following: 

a. The keyboard shift attribute specified in position 35 (such as 
alphameric shift or numeric only) can restrict input keying to certain 
characters. 

b. If the keyboard shift attribute is numeric shift, the data type (character 
or numeric) is set by the entry in positions 36 through 37 (decimal 
positions) and restricts input keying to certain characters. 

c. The CHECK(FE), CHECK(MF), and CHECK(ME) keywords, if specified, 
restrict input keying. 

2. Either of the following: 

a. If CHECK(AB) is specified, data management passes the input data to 
the program (blanks for a character field and zeros for a numeric field). 
No further validity checking is done. 

b. If CHECK(AB) is not specified, data management performs the 
following validity checking functions before passing the data to the 
program: CHECK(VN), CHECK(MIO), CHECK(M11), COMP(. . .), 
RANGE(. . .), VALUES(. . .). 
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CHECK foilowing example shews how to specify the CHECK(AB) keyword: 
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(ME) Mandatory Enter: This code specifies that at least 1 character of data (a 
blank is valid) must be entered into the field. Note that when no field currently 
on the display has been modified, the 5250 work station does not enforce 
mandatory enter. To enforce mandatory enter, specify DSPATR(MDT) for at 
least one field in each record on the display. For all other fields in the record, 
CHECK(ME) is then enforced. However, because the device cannot determine 
if the user has entered data to a field with both DSPATR(MDT) and 
CHECK(ME), you should also specify DSPATR(ND) so that this field is not 
displayed. 

This code is valid only for the 5250 work station and is ignored for the system 
console. 


(MF) Mandatory Fill: This code specifies that if any part of the field is altered, 
all positions in the field must have a character entered. Blanks are considered 
valid characters. 

This code is valid only for the 5250 work station and is ignored for the system 
console. This code cannot be specified with keyboard control codes RB or RZ. 


IBM Modulus 10 or 11 Algorithm: This code specifies that data entered into 
the field must satisfy the IBM Modulus 10 (M10) or Modulus 11 (Mil) 
self-check algorithm. You cannot specify both the Modulus 10 and the 
Modulus 11 self-check algorithms for the same field. A self-check field is 
composed of two parts: the base number (for example, your control or account 
number) and one check digit. The check digit is the rightmost digit in the field. 
The following is an example of an 8-digit self-check field: 

6 3 7 1 2 5 7 1 
>---/ 

Base Check 

Number Digit 

Notes: 

1. CPF supports a maximum length of 31 digits for numeric fields. 

2. The CHECK(MIO) and CHECK(M11) keywords cannot be specified with the 
COMP(EQ) keyword. 

For each position in the base number, there is a Modulus 10 weight factor and 
a Modulus 11 weight factor. Positions are counted from the rightmost digit 
(not including the check digit). 
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The Modulus 10 weight factor is 2 for positions 1,3,5,. . 31; it is 1 for 

positions 2,4,6, . . ., 30. The Modulus 11 weight factors are 
2,3,4,5,6,7,2,3,4,5,6,7,. . .,2,3,4,5,6,7,2 for positions 1,2,. . ., 31, respectively. 

To compute the Modulus 10 self-check digit, do the following: 

1. Multiply the units position and every alternate position of the base 
number by 2. 

2. Add the digits in the products to the digits in the base number that were 
not multiplied. 


3. Subtract the sum from the next higher number ending in zero. 
The difference is the self-check digit. 

For example: 


Base number 


6 12 4 8 


Units position and every alternate 
position 

Multiply by the weight factor, 2 
Products 


6 2 8 

x2 x2 x2 

12 4 16 


Digits not multiplied 


4 


Add the digits of the products and 1+2 + 4+1+6 + 

the digits from the base number not 1 + 4 = 19 

used for multiplication 

Next higher number ending in 0 20 


Subtract 


-19 


Self-check digit 


1 



To compute the Modulus 11 self-check digit, do the following: 
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1. Assign a weight factor to each digit position of the base number. These 
factors are: 2, 3, 4, 5, 6, 7, 2, 3, 4, 5, 6, 7, 2, 3, , , , starting with the units 
position of the number and progressing toward the high-order digit. For 
example, the base number 991246351 would be assigned the weight 
factors as follows: 

Base number 991 246351 

Weight factors 432765432 

2. Multiply each digit by its weight factor. 

3. Add the products. 

4. Divide this sum by 11. 

5. Subtract the remainder from 11. 

The difference is the self-check digit. 

For example: 


Base number 
Weight factors 

Multiply each digit by its weight 
factor 

Add the products 
Divide the sum by 11 
Subtract the remainder from 11 
Self-check digit 


1 

3 

7 

3 

9 

x6 

x5 

x4 

x3 

x2 

6 

15 

28 

9 

18 

6 + 

15 

+ 28 + 

9 + 18 = 76 

76/11 = 

6 plus a remainder of 

11 - 

• 10 

= 1 




1 


Note: If the remainder in step 4 is 0, the self-check digit is 0. If the 
remainder is 1, the base number has no self-check digit; you must make sure 
that such base numbers are not used in the fields you define as self-check 
fields. 


(VN) Validate Name: Use this code to specify that the input field must contain 
a valid name. The first character must be $, #, @, or A through Z. The 
remaining characters must be alphameric ($, #, @, A through Z, 0 through 9, 
or underscore (_)) and must not contain embedded blanks. 
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CHECK The following example shows how to specify the CHECK keyword: 
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Keyboard Control 

When the CHECK keyword is used with a keyboard control code, it controls 
certain data-entry aspects at the 5250 work station only. The valid keyboard 
control codes are: 


Keyboard 


Control Code 

Meaning 

ER 

End of record. 

Equivalent to AUTO(RA). 

FE 

Field exit check. 

LC 

Lowercase. Equivalent to LOWER. 

RB 

Right-adjust with blank fill. Equivalent 
to AUTO(RAB). 

RZ 

Right-adjust with zero fill. Equivalent 
to AUTO(RAZ). 


(ER) End of Record: Use this code to eliminate the need for the work station 
user to press the Enter/Rec Adv key. Whenever the work station user keys a 
character (including a blank) into the last position of the field, the record is 
sent from the device just the same as if the Enter/Rec Adv key had been 
pressed. If you also specify DSPATR(SP) for the field, the record Is sent from 
the device as soon as the work station user selects the field. If you use this 
function, it should be on the last field entered by the user for this record. 

Option indicators are valid with this keyword. 

Note: If specified on a subfile record format, option indicators are valid with 
the CHECK(ER) function only if subfile page equals subfile size (see the 
SFLPAG keyword description). 


(FE) Field Exit Check: This code specifies that the work station user cannot 
advance to the next input field without pressing one of the field exit keys. The 
cursor remains under the low-order character position of the field until a valid 
field exit key has been pressed, even though that character has been keyed in. 
If the user presses any other key, an error results. 

Valid field exit keys depend on the type of keyboard layout being used. This 
code applies only to input fields the work station user can key into. This code 
is valid only for the 5250 work station and is ignored for the system console. 


(LC) Lowercase: Use CHECK(LC) for input-only or output/input fields to permit 
the work station user to enter lowercase a through z. The way the work 
station user keys in the characters (uppercase or lowercase) is the way the 
characters appear on the screen and are returned to your program. 

Your program can display a field that contains both uppercase and lowercase 
characters on both the 5250 work station and the system console. 
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Display Files 

CHECK you specify this keyword, the following occurs when the work station user 

keys into the field: 

• On the 5250 work station, lowercase a through z remain lowercase. 

• On the system console, lowercase a through z remain lowercase. 

If you do not specify this keyword, the following occurs when the work station 
user keys into the field: 

• On the 5250 work station, lowercase a through z are changed to uppercase. 

• On the system console, the entire field is changed to uppercase if any 
position in the field is keyed into. 

The CHECK(LC) keyword has no effect on data-entry keyboards. Data-entry 
keyboards do not support lowercase characters a through z. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the CHECK(LC) keyword: 
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(RB) Right Adjust With Blank Fill: Use this code to specify that data characters 
entered into this field are to be automatically right-adjusted and the leading 
characters are to be filled with blanks. 

Option indicators are not valid with this keyword. 

Notes: 

1. You do not need to specify CHECK(RB) for a signed numeric field; when no 
specification is made, right-adjust with blank fill is the default. 

2. CPF automatically performs zero suppression for a signed numeric, 
input-capable field when CHECK(AB) is specified or is used as the default. 

3. A value of zero appears as all blanks on the display. 


(RZ) Right Adjust With Zero Fill: Use this code to specify that data characters 
entered into this field are to be right-adjusted automatically and the leading 
characters are to be filled with zeros. 

A signed numeric field not specified as right-adjust (RB or RZ) is treated as if 
specified as RB. Right-adjust is activated only by pressing the Field Exit, the 
Field +, or the Field - key. If a right-adjust field is exited through cursor 
movement keys, the field is not right-adjusted (it is left as Is). Right-adjust 
fields longer than 15 character positions slow keyboard entries. The Dup key 
fills a right-adjust field from the cursor location to the end of the field with the 
duplication character (hex 1C), but the field is not right-adjusted. 

Option indicators are not valid with this keyword. 
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The following example shows how to specify the CHECK keyword for 
right-adjust with blank fill (RB) and for right-adjust with zero fill (RZ): 
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This would appear on the screen as follows: 


Data Keyed In 


Key Pressed Result on Screen 


DATA01 L2 3_ 

DATA02 _ 1 _ 2 ^ 3 1. 
DATA03 __i23__ 

DATA06 1^2 3 4 ^5 


Field - key 
Field Exit key 
Field + or 
Field - key 
Field Exit key 


_ 123 :^ 

2 ^3 I. 

0 gg 0123 _ 
0 0 0 gi2 3 ^ 
01 , 234.5 


Note: Right-adjust and blank or zero fill depends on the number of positions 
the work station user keys into and whether or not a screen position is 
reserved for the sign (signed numeric field). 
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Cursor Control 
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When the CHECK keyword is used with a cursor control code, it specifies that 
the cursor is to move from right to left at a 5250 work station. Right-to-left 
cursor support requires the right to left feature on your system. See the CPF 
Programmer's Guide for more information concerning this support. 

CPF does not ensure that right-to-left files are opened only for work stations 
capable of right-to-left cursor movement. Therefore, all work stations in the 
same system should be configured with the same language capability and with 
the same right-to-left capability. 

The valid cursor control codes that can be specified for cursor control are: 

Cursor 

Control 

Code Meaning 

RL RIght-to-left cursor movement within fields 

RLTB Right-to-left, top-to-bottom cursor movement 

from field to field 

The right-to-left capability Includes the following restrictions: 

• Right-to-left files cannot be sent to the system console. 

• The check digit for modulus checking is the rightmost byte in the field. 

• Katakana cannot be used with right-to-left support. 

• CHECK(RL) and CHECK(RLTB) cannot be specified with user-defined 
records (having the USRDFN keyword). 

A warning message is issued for the following conditions: 

• A right-to-left field that also allows magnetic card reader operator 
identification data (DSPATR(OID) keyword). 

• A right-to-left field that spans more than one line. 

• A right-to-left field that is also a self-check field (CHECK(MIO) or 
CHECK(Mll) keyword). 

• A right-to-left field for which CHECK{RZ) or CHECK(RB) Is specified. 
Option indicators are not valid with cursor control codes. 
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check Us® ^*^® CHECK(RL) keyword at the file, record, or field 

level to specify that the cursor should rnove from right to left within 
input-capable character fields. At the file level, specifying CHECK(RL) makes 
the cursor move from right to left in all input-capable character fields in the 
file. At the record level, specifying CHECK(RL) makes the cursor move from 
right to left in all input-capable character fields in the record. At the field level, 
specifying CHECK(RL) makes the cursor move from right to left in only the 
field with which it is associated. 

The following example shows how to specify the CHECK(RL) keyword at the 
file level: 
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Note: If you want to specify the RL cursor control code with an edit/check 
code, you can do so only if the edit/check code is valid at the level you 
specify. In the following example, CHECK(RL AB) is specified at the record 
level because AB is valid at that level; CHECK(RL MF) is specified at the field 
level because MF is valid only at that level: 
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(RLTB) Right to Left, Top to Bottom: Use the CHECK(RLTB) keyword only at 
the file level. It specifies the direction the cursor is to advance from 
input-capable field to input-capable field. CHECK(RLTB) specifies that upon 
exiting from a field, the cursor advances by moving from right to left and from 
top to bottom of the display until It reaches the next input-capable field. You 
can specify the RLTB cursor control code with only the edit/check code AB, as 
the others are not valid at the file level. 

Note: Specifying CHECK(RLTB) does not change which input-capable field the 
cursor is positioned in when the display initially appears. See the CPF 
Programmer's Guide for a description of cursor positioning. 

The following example shows how to specify the CHECK(RLTB) keyword: 
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CHGINPDFT 

Use this file, record, or field level keyword (change input default) to specify 
that an input-capable field (input only or output/input) is not to be underlined 
by default. When used at the file level, this keyword applies to all 
input-capable fields in a file. When used at the record level, this keyword 
applies to all input-capable fields in the record. 

Option indicators are not valid with this keyword. This keyword does not 
prohibit you from also specifying the DSPATR(UL) keyword either with or 
without option indicators. 

When DSPATR(UL) is specified, the CHGINPDFT keyword has no effect on the 
field. 

The following example shows how to specify the CHGINPDFT keyword: 
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_ And/Or/Comment (A/0/*) 


CLEAR[(response-indicator ['text'])] 
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Use this file or record level keyword to specify that your program is to receive 
control if the work station user presses the Clear key, and optionally, that CPF 
is to set on the specified response indicator. The Clear key is processed like a 
CA key (no input data is transmitted from the device). CPF does not clear the 
screen; your program must perform the desired function (such as clearing fields 
or records from the screen). 

If you do not specify this keyword and the work station user presses the Clear 
key, CPF displays a message indicating that it is not valid at that time. This 
keyword is ignored for the system console; it is valid for the 5250 work station 
only. 

Note: On the 5250 work station, the Clear key is pressed by pressing CMD, 
then the left arrow above the Field Exit key. 

The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 

Option indicators are valid with this keyword. 

The following is an example of how to specify the CLEAR keyword: 
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CLRU*NO|nn) 

Use this record level keyword (clear line) to specify that before the record is 
displayed CPF is to clear (erase) a specific number of screen lines. Only those 
lines are cleared. (Note that as with OVERLAY, other records remain on the 
screen.) You can specify one of two parameter values for the CLRL keyword: 

• Specify *NO so that no lines on the screen are cleared before displaying the 
the record whose format you are defining. The displayed record overlays 
any data already displayed on the screen. 

• Specify nn, where nn is an integer between 1 and 24. The number specified 
is the number of lines cleared, starting with and including the first line on 
which the record is to be displayed. If the SLNO keyword is also specified 
for this record format, the clearing of lines begins with the starting line 
number in effect for the record format at the time it is displayed. 

If the record format for which the CLRL keyword is specified has one or more 
input-capable fields, any records that are overlaid are no longer recognized by 
CPF. That is, any input-capable fields can no longer be keyed into, any input 
operation issued to one of those records results in an error, and they cannot be 
erased by selecting the ERASE keyword. However, if the record format for 
which the CLRL keyword is specified has no input-capable fields, any records 
that are overlaid continue to be recognized by CPF. That is, input-capable 
fields in the overlaid records remain input-capable, and input operations issued 
to those record formats are still valid. Also, such a record format may not be 
properly erased when it is overlaid by another record or when it is erased 
through the use of the ERASE keyword on another record format. 

If the CLRL keyword is not specified and neither OVERLAY nor PUTOVR is 
specified, the entire screen is erased. 

If you specify the CLRL keyword, the record format must have at least one 
displayable field. 

The CLRL keyword cannot be specified with any of the following keywords: 

ASSUME 

KEEP 

SFL 

SFLCTL 

USRDFN 

The CLRL keyword cannot be specified for the record format specified by the 
PASSRCD keyword. 

Option indicators are not valid with the CLRL keyword. 
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The following example shows how to specify the CLRL keyword 
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CMP(relational-operator-code constant-value) 

The CMP keyword is equivalent to the COMP keyword. The COMP keyword is 
preferred because it is compatible with DOS on other systems. See the COMP 
keyword description for an explanation of how to use these keywords. 


COMP(relational-operator-code constant-value) 

Use this field level keyword (comparison) to specify that CPF is to compare the 
data that the work station user enters into an input or output/input field with 
the specified constant value. The relational operator code is the criterion for 
the comparison. If the data entered in this field fails this validity check, CPF 
displays an error message. The valid entries for the relational operator codes 
are: 


Code 

Meaning 

EQ 

Equal 

NE 

Not equal 

LT 

Less than 

NL 

Not less than 

GT 

Greater than 

NG 

Not greater than 

LE 

Less than or equal 

GE 

Greater than or equal 


The specified constant value must be either numeric or character, depending 
on the data type (decimal positions entry). Numeric constants are expressed by 
the digits 0 through 9 and a leading sign (+ or -). Character constants must be 
enclosed in apostrophes. 

Note: If the field named (to be compared with) is a numeric field, alignment is 
based on the decimal positions specified (in positions 36 and 37), and leading 
and trailing blanks are filled with zeros. If no decimal point is keyed in, the 
decimal point is assumed to be to the right of the last (rightmost) digit. For 
example, for a numeric field with a length of 5 (specified in column 34) and 2 
decimal positions (specified in column 37), 1.2 is interpreted as 001.20, and 
1(X) is interpreted as 100.00. 

You can specify only one operation for the COMP keyword and only one 
COMP keyword for a field. 

Option indicators are not valid with this keyword. 


T 



The following example shows how to specify the COMP keyword 
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CSRLOC(field-nanne-1 field-name-2) 

Use this record level keyword (cursor location) to specify the cursor location on 
an output operation to the record format you are defining. Your program 
issues the output operation after setting the cursor location. The parameter 
values on the keyword specify the names of two fields whose contents are the 
line number (for field-name-1) and the position number (for field-name-2) of 
the cursor location. Field-name-1 and field-name-2 are 3-byte, zoned 
decimal, hidden fields; your program uses these fields to tell CPF where to 
locate the cursor. 

The cursor is not positioned to the desired location on an output operation that 
leaves the keyboard locked. The cursor does not move to the desired position 
until your program issues an input or an output operation that unlocks the 
keyboard. If your program sets the cursor location fields to values outside the 
range of values valid for the display device, this keyword is ignored. 

For any one output operation, the CSRLOC keyword overrides any other cursor 
location specifications, such as DSPATR(PC) and SFLRCDNBR(CURSOR), that 
are in effect. This keyword is in effect until your program issues another 
output operation with DSPATR(PC), CSRLOC, or SFLRCDNBR(CURSOR) in 
effect or until the record in which this keyword is specified is overlaid 
(OVERLAY keyword) or erased (ERASE keyword), whichever comes first. 

Specify the CSRLOC keyword only once per record format. 

The CSRLOC keyword is not valid for the following record formats; 

• Subfile record formats (identified by the SFL keyword) 

• User-defined record formats (identified by the USRDFN keyword) 

Option indicators are valid with this keyword. Screen size condition names are 
not valid. 
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DATE 


Use this field level keyword to specify that CPF is to retrieve the current job 
date (the date the job was started) and display it as a constant field. The 
following information is implied for the field, and you cannot specify it; 

• The output-only attribute 

• A field length of 6 positions 

You can specify only the location of the field on the screen. Positions 17 
through 38 must be blank. 

You can optionally specify an edit code or an edit word for this field (see the 
EDTCDE and EDTWRD keywords). If no edit code or edit word keyword is 
specified, no editing takes place. 

Option indicators are not valid for this keyword. 

Notes: 

1. The Y edit code uses the character in the system value QDATSEP, as the 
date separator character. When DATE and EDTCDE{Y) are specified 
together on a constant (unnamed) field, the data is edited according to the 
system values QDATSEP (date separator character) and QDATFMT (date 
format). See the description of the EDTCDE keyword for more information 
on how the date is edited. 

2. At execution time. If QDATFMT is JUL (Julian), and any edit code Is 
specified, CPF puts a zero in the sixth position. EDTCDE(Y) should be used. 

The following example shows how to specify the DATE keyword: 



4-74 

















































DFT('nterar) | literal' 

Use this field level keyword to specify the constant value for constant fields 
(unnamed fields) and to specify a default value for named fields. 
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Constant Fields: 

The value of a constant field can be specified as a literal enclosed by 
apostrophes. (For other ways to specify a constant field, see the DATE and 
TIME keywords.) You can omit the OFT keyword itself, as well as the 
parentheses, to simplify the DDS. Whether you specify the DFT keyword 
explicitly or implicitly, CPF displays the specified literal as a constant field on 
the screen. See Name (Positions 19 through 28) earlier in this chapter for a 
description of constant fields. 


Named Fields: 

For input-only fields, the specified literal is displayed when the field is 
displayed. The displayed value can then be changed by the work station user 
and returned to your program. For output-only, output/input, and message 
fields, you must also specify PUTOVR at the record level and OVRDTA at the 
field level with the DFT keyword. (For more information and an example, see 
the PUTOVR keyword.) 

The EDTCDE and EDTWRD keywords cannot be specified with the DFT 
keyword. 

Option indicators are not valid with this keyword, although option indicators 
can be used to condition the field (whether constant or named) with which it is 
specified. 
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The following example shows how to specify the DFT keyword: 
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The constant field 'ON', having no option indicators, is always 
displayed. 

If indicator 01 is on, the following is displayed: 

HOTEL NAME: 'TERRACE INN' 

If indicator 02 is on, and indicator 01 is off, the following is displayed: 
HOTEL NAME: 'RIVER VIEW INN' 



















If you are specifying a constant field for more than one screen size, and you 
are not changing the contents of the field for the different screen sizes, only 
the location of the field, then do not repeat the literal. The following example 
shows how to do this: 
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The constant field 'Constant data' appears on line 22, position 2, on 
the 24 by 80 display screen, and it appears on line 10, position 2, on 
the 12 by 80 display screen. 
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DLTCHK 

Use this field level keyword to specify that CPF is to ignore all validity checking 
keywords that are specified for a referenced field. This keyword is valid only 
when R is specified in position 29. 

If you specify any new validity checking keywords, DLTCHK is unnecessary; 
the new validity checking keywords override the referenced validity checking 
keywords. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the DLTCHK keyword: 
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Use this field level keyword to specify that CPF is to ignore the EDTCDE or 
EDTWRD keyword if one of them is specified for a referenced field. This 
keyword is valid only when R is specified in position 29. 

If you specify a new editing keyword, DLTEDT is unnecessary; the new editing 
keyword overrides the referenced editing keyword. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the DLTEDT keyword: 
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DSPATR(attribute-1 [attribute-2 [attribute-3 [...]]]) 

Use this field level keyword to specify one or more display attributes for the 
field you are defining. You can specify the DSPATR keyword more than once 
for the same field, and you can specify more than one attribute for the same 
keyword. However, each attribute (for example, UL), can be specified only 
once per field. The following are valid attributes: 

Display 

Attribute Meaning 

For All Fields 

BL Blinking field 

CS Column separator 

HI High intensity 

ND Nondisplay 

PC Position cursor 

Rl Reverse image 

UL Underline 

For Input-Capable Fields Only 

MDT Set modified data tag when displayed 

OID Operator identification 

W Protect contents of field from input keying 

SP Select by light pen 

Notes: 

1. If you specify the UL, HI, and Rl attributes on the 5250 work station for the 
same field, the result is the same as if you had specified ND. 

2. If OID is specified, then SP should not be specifed. Neither OID nor SP can 
be optioned unless specified with another display attribute. 

Option indicators are valid with this keyword, except when the attributes OID 
or SP are the only display attributes specified. 

Detailed descriptions of each of the attributes follow the coding example and 
sample display provided in Figure 4-5. 
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Intvrnmional Bucinen Machine* Corporation 


DATA DESCRIPTION SPECIFICATIONS \ 


File 

Programmer 


Page of 


Sequence < 

Number \v\ 
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Figure 4-5. A 5-byte Field Displayed with Various Display Attributes 
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A description of each of these attributes follows: 


(BL) Blink: Use this attribute to specify that the field is to blink when it is 
displayed on the screen. 

This attribute is valid only for the 5250 work station; it is ignored for the 
system console. 


(CS) Column Separator: Use this attribute to specify that each position of the 
field is to be displayed with a vertical bar at its left and right edge. When 
specified for a nondisplay field, the separators are displayed even though there 
are no characters between them. You can use column separators to precisely 
indicate cursor positioning within a field and to indicate the length of an 
otherwise blank field. 

This attribute is valid only for the 5250 work station; it is ignored for the 
system console. 


(HI) High Intensity: Use this attribute to specify that the field is to be 
intensified (highlighted) when it is displayed on the screen. 

This attribute is valid only for the 5250 work station; it is ignored for the 
system console. 


(ND) Nondisplay: Use this attribute to specify that the field is not to be 
displayed on the screen; the screen positions for this field appear blank. The 
attribute can be used for passwords or other security-sensitive data. If the 
print function (permitted by specifying the PRINT keyword) is performed, 
nondisplay fields are not printed. 

This attribute is valid for the system console and the 5250 work station. 


(PC) Position Cursor: Use this attribute to position the cursor to the first 
character position of the field you are defining. You can specify this attribute 
for several fields, and the cursor will be positioned at the first selected field 
with this attribute. Note that the fields within a record are ordered in 
line/position sequence as they appear on the screen and not necessarily in the 
order you specify them. 

For a detailed discussion of cursor positioning, see the CPF Programmer's 
Guide. 

This attribute is valid for the system console and the 5250 work station. 
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(Rl) Reverse Image: Use this attribute to specify that the image of the field is dspatr 

to be reversed from the rest of the screen when it is displayed. Whether the 
screen is light-on-dark or dark-on-light depends on the state of the screen 
prior to displaying the field; this setting is controlled by the work station user. 

This attribute is valid only for the 5250 work station; it is ignored for the 
system console. 


(UL) Underline: Use this attribute to specify that the field is to be underlined 
when it is displayed on the screen. All input-capable fields are underlined by 
default; see the CHGINPDFT keyword to prevent the default underlining. (If 
CHGINPDFT is specified, DSPATR(UL) must be specified to underline an 
input-capable field.) If DSPATR(UL) is specified with option indicators and the 
option indicators are not satisfied (DSPATR(UL) not selected), the field appears 
without underline. 

This attribute is valid for the system console and the 5250 work station. 


(MDT) Set Modified Data Tag: Use this attribute to specify that CPF is to set 
on the modified data tag (MDT) for the field you are defining when the field is 
written to the display. The attribute ensures that the field is sent from the 
device when the record is read from the display. On a subfile record format, 
option indicators are valid for this attribute only if the value specified for 
SFLPAG equals the value specified for SFLSIZ (see the SFLPAG keyword 
description). 

This attribute is valid for the system console and the 5250 work station. 

Note: CPF saves output data for output/input fields or initialized data for 
fields with the DFT keyword specified. This causes the saved data to be 
returned on an input operation if no new (modified) data is keyed into the field. 

This attribute is valid for input-capable fields and is not valid for output-only 
fields or unnamed constant fields. 


(0/D) Operator Identification: Use this attribute to specify that CPF is to allow 
magnetic stripe reader 01D data to be entered into this field. If it is to be a 
nondisplay field also, the DSPATR(ND) attribute must be specified. 

Magnetic stripe data can be entered into any input field. However, if the data 
is operator identification, this attribute must be specified. If no magnetic stripe 
reader exists at the work station in use, this keyword is ignored. The same 
field can be specified as a light-pen-selectable field, by means of 
DSPATR(SP), and as an operator identification field, by means of 
DSPATR(OID). However, if both of these attributes are specified, DSPATR(SP) 
is ignored. Because option indicators are valid for neither keyword, they should 
not be specified on the same field. 

This attribute is valid only for the 5250 work station; it is ignored for the 
system console. 
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(PR) Protect: Use this attribute to specify that the work station user cannot 
key into the input-capable field you are defining. This attribute is valid for 
input-capable fields only; output-only fields and constant fields are protected 
by definition. On a subfile record format option indicators are valid for this 
attribute only if the value specified for SFLPAG equals the value specified for 
SFLSIZ (see the SFLPAG keyword description). 

This attribute is valid for the system console and the 5250 work station. 


(SP) Select By Light Pen: Use this attribute to specify that this field is a 
light-pen-seiectable field. The work station user can key into a light pen field 
unless an I (Inhibit keyboard entry) has been specified in position 35 (Data 
Type/Keyboard Shift) for the field. 

When the field is first displayed, the contents of the field are set by your 
program (output/input field) or In the DDS (input-only field with DFT keyword 
or literal). If no new data is entered by the work station user, this output data 
is returned to your program on an input operation. 

The recommended contents of this field are: 

• A switch character, either hex 6F (?) or, if the work station user selects the 
field by a light pen, hex 6E (>) 

• A blank (hex 40) 

• A target character, which can be any character, such as an asterisk (*) 

• Another blank 

• Additional data to Identify the field to the work station user (1 or more 
characters) 
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The following example shows how to specify the DSPATR(SP) keyword with 
ar\ input-only field (showing the recommended data contents as a literal): 


display files 
QSPATR ^ 


Sequence < 

Number c 


1 2 3 4 6 6 7 
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When the work station user selects a field with the light pen, both the MDT bit 
and the first character of that field are changed. When the field is selected, 
the MDT bit is set on, changing the first character of the field to >. If the 
same field is selected again, the MDT bit is set off and the first character 
becomes ?. 

By specifying a switch character, your program prevents the first character of 
data from being changed to > or ? when the field is selected by the light pen. 

If the MDT bit is on when your program issues an input operation to the 
record format, the contents of the field are returned to your program as a 
user-modified field. 

If you use DSPATR(MDT) to set on the MDT of a light-pen-selectable field, 
then you should either omit the MDTOFF keyword from other record formats 
or you should read the light-pen-selectable field before displaying any record 
format with MDTOFF in effect. The following example shows what could 
happen: 
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in tnis example, it tne program oispiays Liunirci^i, man ui%>piay:> 

RCD2, then reads LIGHTPEN, and the work station user does not 
select FLD1 with the light pen, the MDT of FLD1 is turned off by the 
display of RCD2. 

Also, the switch character of FLD1 is returned as ?, even though the 
field was not selected, and the switch character appears as >. The 

MDT and the switch character are in opposing states. 












Notes: 

1. This attribute is useful only for the 5250 work station with light pens and is 
ignored for the system console. 

2. This attribute Is only valid for input-capable fields. 
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DSPSIZ(DSx[*DSy[*DSz]]) 

DSPSIZdines chars [condition>name-1][lines chars[condition-name-2] 

[lines chars[condition-name-3]]]) 

Use this file level keyword to specify the display size to which your program 
can open this display file. The DSPSIZ keyword Is optional; if you do not 
specify it for a display file, the display file can be opened only to display 
devices with a 24 by 80 screen size. You can specify this keyword in one of 
two ways: 

• Using IBM-supplied screen size condition names: Specify up to three 
parameter values as *DS1, *DS2, or *DS3, in any order. At least one 
parameter value is required; you cannot specify a parameter value twice. If 
you specify more than one parameter value, see Primary and Secondary 
Screen Sizes later In this keyword description. 

• Specifying lines and characters to permit user-defined screen size condition 
names: Instead of the IBM-supplied screen size condition names, specify 
the screen size in lines and characters (only 16 64, 12 80, and 24 80 are 
valid). See Example 2 later in this keyword description. Optionally, you can 
also define a screen size condition name other than *DS1, *DS2, or *DS3. 
The screen size condition name you define must be from 2 to 8 characters 
long, and the first character must be an asterisk {*). You can specify these 
user-defined condition names in positions 7 through 16 (conditioning) on 
subsequent DOS statements at the field level. If you do not specify 
user-defined screen size condition names, you must use IBM-supplied 
screen size condition names to condition the location of fields. 
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Primary and Secondary Screen Sizes 


Whether you use IBM-supplied screen size condition names or specify lines 
and characters directly, the first screen size you specify is the primary screen 
size. The second and third screen sizes, if specified, are secondary screen 
sizes). For example: 


DSPS!Z(24 80 


12 80) 

“Secondary screen size 
-Primary screen size 


DSPSIZ(24 80 12 80 16 64) 

I -/ -Secondary screen sizes 

-Primary screen size 
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When you specify more than one screen size for the DSPSIZ keyword, you can 
specify screen size condition names in positions 7 through 16 on subsequent 
DDS statements at the record and field levels. These screen size condition 
names are then used to condition keywords and the locations of fields. See 
Positions 7-16 (Conditioning) In the Positional Entries section earlier in this 
chapter. Note that if you specify user-defined screen size condition names for 
the DSPSIZ keyword, you cannot use IBM-supplied screen size condition 
names for conditioning. 


Valid Display 
Sizes 

Display Device 

Meaning 

*DS1 or 16 64 

System console 

16 lines by 

64 characters 

1024 characters total 

*DS2 or 12 80 

5251 (Models 1 and 2), 

5252 

12 lines by 

80 characters 

960 characters total 

*DS3 or 24 80 

5251 (Models 11 and 12) 

24 lines by 

80 characters 

1920 characters total 


Option indicators are not valid with this keyword. 
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The following examples show how to specify the DSPSIZ keyword and the 
screen size condition names. 

Example 1: 


Display Files 
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In this example, the primary screen size Q is 24 by 80 and the 
secondary screen size Q is 16 by 64. FIELDB is beyond position 64 
and FIELDC is beyond line 16, so the data description processor gives 
them a location of *NOLOC in the expanded source listing for 
secondary screen size 16 by 64. 


If the data description processor assigns *NOLOC to an input-capable 
field, that field is processed at execution time to the point of setting up 
the input buffer data to be returned in the user's input buffer. The 
field itself is not displayed; the work station user cannot enter into or 
modify these fields. No processing of any kind is done for output-only 
fields. 
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The following is a compiler listing for example 1; 


5714SS1 R03 «00 811204 


File name - 
Source file - 
Type of data 
Options - 
Authority - 
Text - 


DATA DESCRIPTION 


OSPSIZ1.SC217806 Type of file - DISPLAY 

Q00SSRC.SC217806 Member - DSPSIZI 

OOATA 

*SRC *LIST 
♦NORMAL 

Sample listing for DOS manual 

IBM System/38 Data Description Processor 

DATA DESCRIPTION SOURCE 


DSPSIZI.SC217806 
08/07/81 15:03:40 


08/07/81 15:45:56 


SEQNBR 

100 

200 

♦.1 ••• 

A 

A 

R RECOROA 

3 ••• 

••• 

4 . 

••• 5 •«. ••• 6 

0SPSIZ(24 80 16 64) 

300 

A 

FIELDA 

10 

0 

1 

2 

400 

A 

FIELDB 

10 

0 

1 

66 

500 

A 

FIELDC 

10- 

0 

17 

1 


7.8 DATE 


5714SS1 R03 MOO 811204 DATA DESCRIPTION 

EXPANDED SOURCE 

SECINBR ♦••• ••• 1 ••• ••• 2' ••• 3 ••• 4 5 


OSPSIZ1.SC217806 


08/07/81 15:45:56 


100 

200 

300 

400 

400 ♦ ^OSl 

500 

500 ♦ *051 


R RECOROA 
FIELDA 
FIELOB 


••• 5 ••• ••• 6 ••• 7 •«« 8 LEN 

0SPSI2(24 80 16 64) 


iOS 00 12, 

lOS 00 I 66 V 
♦NOLOC f 
lOS 00 17 li 
♦NOLOC r 


♦OS I ♦NOLOCr 

end of expand 


SOURCE 


FIELD BUFFER POSITION 
LEN OUT IN 


FIELDB and FIELDC have 
no location on *DS1, which 
corresponds to 16 64. 


5714SS1 R03 MOO 811204 

MSGIO SEV NUMBER TEXT 


DATA DESCRIPTION 
MESSAGES 


DSPSIZ1.SC217806 


08/07/81 15:45:56 


MESSAGE SUMMARY 

TOTAL INF0(0-9) WARNING!10-19) ERROR(20-29) SEVERE(30-99) 

0 0 0 0 0 


♦ CPF7301 00 File DSPSIZI created in library SC217806. 
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PAGE 2 


PAGE 3 
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Example 2: 
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^ssnMQiiii 
•MiK*snm 

WiWoBMCl 
il^'KQIIIII_ 

'mimam 





■ir 

_^irinafiriii 

ainiir 

^iii 


mill 

a 






Locttlon 




Functiont 

UlM 

Pot 


39 4041 

42 43 44 46 49 47 48 49 8051 S2 83 S4 8S 86 57 B8 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 




IIHM 

htwfmmnwmt 

■■■■nESj 

'i'mmmwmmit 

■■iin^ini 




This example is similar to example except that valid secondary 
locations are specified for FIELDS (line 1, position 49) and for FIELDC 
(line 15, position 1) on the secondary screen size (user-defined as 
*CON). 
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Example 3: 


_ DATA DESCRIPTION SPECIFICATIONS 



File 

Keying 

Instruction 

Graphic 

n 






n 

Programmer | Date 

Kay 

i 






□ 
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Example 4: 
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Length ^ 2 Functions 

I 5 

a I 

• O Line Fot 

I 111 

ISll 

31 32 33 34 38 38 37 38 39 40 41 42 43 44 48 46 47 48 48 80 81 83 63 84 SS 66 57 58 89 60 61 62 63 64 86 86 67 68 89 70 71 72 73 74 76 76 77 78 79 8 





mmrnijmmwk 

III 


IIHII 

mwmwmrnsfi 

imr 


■■■ii 


If you do not specify a screen size condition name, the display location 
of a field can still be screen size dependent as the result of the plus 
feature of DDS. A line and a position for each field is calculated for 
each display size specified on the DSPSIZ keyword. If the plus value 
extends the field location beyond position 64, the field location is 
dependent on the screen size. 
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The following is a compiler listing for example 4: 


5714SS1 R03 MOO 811204 


DATA DESCRIPTION 


File name - 
Source file - 
Type of data - 
Options - 
Authority - 
Text - 
Compiler - 


Type of file - 
Member - 


0SPS1Z4.SC217806 
aOOSSRC.SC217806 
«0ATA 
♦SRC ♦LIST 
♦NORMAL 

Sample listing for DOS manual 

IBM System/38 Data Description Processor 


DISPLAY 

DSPSIZ4 


DSPSIZ4.SC217806 
08/07/81 15:23:26 


08/07/81 15:45:37 


SEQNBR ♦• 

100 

200 

300 

400 


R RECORDA 
FIELOl 
FIELD2 


DATA DESCRIPTION SOURCE 

3 ••• ••• 4 ••• ••• 5 ••• ••• 6 ••• 

OSPSIZi16 64 12 80) 


7 ••• ••• 8 DATE 


21 

10 


50 
♦ 10 


END OF SOURCE 


5714SSI R03 MOO 811204 


SEQNBR ♦••• ••• 1 ••• ••• 2 • 

100 


DATA DESCRIPTION 
EXPANDED SOURCE 

••• ••• 4 ••• ••• 5 •• 


DSPS1Z4.SC217806 


08/07/81 15 : 45:37 


FIELD BUFFER POSITION 
8 LEN OUT IN 


200 ’ 

300 

400 

400 


0SPSIZ(16 64 12 80) 

♦ OPTION INDICATOR OUTPUT BUFFER POSITIONS - 

♦ ♦IN66 0001 

R RECORDA 

66 FIELOl 21 s 00 2 50> 

F1EL02 lOS 00 3 181 

♦0S2 3 2] 

END 


♦ ♦ ♦ ♦ ♦ 


0 F 


EXPANOEI .SOURCE 



21 

10 


2 

23 


FIELDI has same location on *DS1 and *DS2 
FiELD2 has two locations: 

- Line 3, position 18 on *DS1 
— Line 3, position 2 on *DS2 


5714SS1 

MSGID 

R03 MOO 811204 

SEV NUMBER 

TEXT 

DATA DESCRIPTION 

MESSAGES 

0SPSIZ4.SC217806 

08/07/81 15:45:37 

TOTAL 

0 

INF0(0>9) 

0 

WARNING(10-19) 
0 

MESSAGE SUMMARY 

ERROR(20-29) 

0 

SEVERE(30-99) 

0 


CPF 7301 

00 File DSPSIZ4 created in 

library SC217806. 
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Special Cases: The following are descriptions of special cases you might 
encounter when specifying the DSPSIZ keyword: 

• DSPSIZ(*DS1 ’^DSS): All field locations for screen size *DS3 are the same 
as for screen size *DS1. 

• All fields of a record can be described such that none fits on the screen size 
to which the file is opened. In this case, no fields are displayed. The record 
is handled as it would be for a larger screen where the fields fit. The record 
remains active until it is erased or overlaid. Active records can be read by 
your program; the input request is sent to the display device, and the work 
station user must respond to satisfy the request. 

• All fields of a subfile record must fit within the specified subfile page, and 
the complete page must always fit (vertically) on the screen size on which it 
is displayed at execution time. Specify valid screen sizes by conditioning the 
SFLPAG keyword with screen size condition names. (Note that fields with 
display locations between 65 and 80 can still be specified but are not 
displayed on the system console.) See example 17 in Appendix F, Examples, 
for a subfile that can be displayed on two screen sizes. 

• The following records occupy no screen space: 

- Records with no fields defined (this is different from none selected) 

- Records with only hidden or message fields 

- Records that have the CLRL keyword specified and that have no 
input-capable fields (these records can remain on the screen, but are not 
recognized by CPF for input operations or be erased through the use of 
the ERASE keyword) 

For implementation and programming purposes, these records are assumed 
to be located at 00 (from line 0 to line 0). On an output operation, any 
record located at 00 overlays a record at that location. When an overlap 
occurs, the previous record is disregarded and no longer considered active. 
The new record at location 00 is active and can be read by your program. 

• If two fields in a record format have the same display location 
(line/position), they are treated as overlapping fields. Overlapping fields are 
not displayed at execution time. CPF checks each field as it is processed to 
ensure that it does not overlap a previously processed field. 

If a field does overlap, it is treated as an optioned field and not selected. 

To allow this execution-time checking, data description specifications must 
ensure ail fields within a record are in primary location sequence, even when 
condition names are specified. For example, assume only one input field is 
specified for a record format and, according to the field location 
specification, this field overlaps a preceding output field. The work station 
user cannot enter any data because the input field is never displayed. 

Note: The primary location sequence as it is seen in the display file must not 
be changed by specifying a different location sequence for secondary screen 
sizes. (A severe error occurs, and the file is not created.) 
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DUP[(response-indicator ['text'])] 

Use this field level keyword to specify that the work station user can press the 
Dup key on the 5250 work station keyboard. The work station user presses 
the Dup key when the cursor is in this input-capable field to indicate that data 
for this field is to be duplicated from the record received on the previous input 
operation. 

The actual duplicating function is the responsibility of your program. This 
keyword is valid for the 5250 work station; it is not valid for the system 
console. 

When CPF recognizes that the user has pressed the Dup key (by detecting hex 
1C in any field position), it handles the field as follows: 

• If you have specified a response indicator or if the field is a character data 
type field, the data received from the display is returned to your program 
just as it was received. When the field is numeric, your program must be 
aware that arithmetic operations on the data passed to the program can 
cause an invalid data exception. 

• If you do not specify a response Indicator and the field is numeric, a value 
of zero (all hex FOs) is returned to your program. 

• If you specify a response indicator and the field is numeric, the response 
indicator is set on when CPF detects hex 1C in the field. The indicator 
remains on until the record is returned to your program. 

When the Dup key is entered in a field, the indicator is set on. If a 
subsequent field fails validity checking (for instance RANGE keyword 
specified), CPF reissues a read to the display. If the user modifies the DUP 
field but does not press the Dup key, the DUP response indicator is 
returned to your program in the on condition, even though the input field no 
longer contains the DUP character. 

• When CPF-detected input errors require additional input from the work 
station user, the response indicator for DUP remains on until the record is 
returned to your program. 

Validity checking keywords (RANGE, VALUES, COMP, CHECK) can be 
specified with the DUP keyword; however, no field validation is done by CPF if 
the Dup key has been pressed. 

The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 
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If specified on a subfile record format option indicators are valid for the DUP 
keyword only if the value specified for the SFLPAG keyword is equal to the 
value specified for the SFLSIZ keyword (see the SFLPAG keyword description). 

Option indicators are valid with this keyword. 

The following example shows how to specify the DUP keyword: 
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a- 




Ckrnditioning 

i 

c 

?! 

17 1! 

Name 

1 

c 

B 19 20 21 22 23 24 25 26 27 28 

g Reference (R) 

Length 

30 31 32 33 34 

1 

z 

> 

X 

% 

m 

w 

oT 

< 

A 

K 

H 

a 

35 

^ Decimal 

y Positions 

5 

I 

m 

O 

1 

38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

12 3 4 

5 

® Form Type 

O 

< 

c 
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E 

8 

6 

7 

z 

S 

z 

Condition Name 

(0 

^ Indicator 

z 
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z 

11 

.1 

12 13 

Z 

i 

14 

1 
1 
IS 16 

Line 

39 40 41 

Pos 

42 43 44 


E 

A 




n 

I 






n 


¥ 

msm 



g. 




!! 

3 

2 

P 

0 

? 

( 

i. 6 FLDA mIas 




E 

Q 

1 

1 








1 

■1 

13 

Lil'dH 




i.^ 



n 

wm 

t 

DO 

? 





in: 


D 

1 

■ 

1 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■1 

II 

HHH 

■ 


1 

HHHI 

1 

IB 

1 

IB 

Bl 

1 

1 

1 

1 


1 

|! 

I- 



Q 

■ 

■ 








■1 

II 

HHI 

■ 

Bi 

1 

HHi 

1 

■ 

1 

iBfi 

Bl 

1 

1 

1 

1 


1 

Il 

It^ 




r 

n 

r 







I 
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m 

m 
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n 

n 

r 

; . 

m 

r 
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EDTCDE(eclit-code [* \ floating-currency-symbol]) 

Use this field level keyword to specify an edit code for editing of output data 
for a numeric-only field (Y specified in position 35) using this current field 
description. An edit code is a required parameter value for this keyword. 

EDTCDE is valid only for numeric-only fields. Both EDTCDE and EDTWRD 
keywords cannot be specified for the same field. You can use the EDTCDE 
keyword to perform edit functions such as the following: 

• Suppress leading zeros 

• Omit a sign from the low-order position of the field 

• Punctuate the field without having to specify an edit word (see the 
EDTWRD keyword description) 

• Perform asterisk fill 

• Specify floating currency symbol (this symbol must correspond to the 
system value QCURSYM) 

• Perform user-defined edit functions 

Option indicators are not valid with this keyword. 


CPF Edit Codes: The edit codes that you can specify as a parameter value for 
this keyword are: 

1 through 4 
A through D 
J through M 
Yand Z 

Edit code X has no effect on display files. For an explanation of its use, see 
the EDTCDE keyword descriptions in Chapter 2, Physical Files and Chapter 3, 
Logical Files. 
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The following chart summarizes the functions provided by CPF edit codes. A 
negative field can be punctuated with no sign, CR (credit), or a minus. 
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Edit 

Code 

Commas^ 

Displayed 

Decimal 

Points^ 

Displayed 

Sign Displayed When 
Negative Number 

Zero 

Balance 

Displayed 

Leading 

Zero 

Suppressed 

No Sign 

CR 

- (Minus) 

1 

Yes 

Yes 

No sign 



Yes 

Yes 

2 

Yes 

Yes 

No sign 




Yes 

3 


Yes 

No sign 



Yes 

Yes 

4 


Yes 

No sign 




Yes 

■1 

Yes 

Yes 


CR 



Yes 

B 

Yes 

Yes 


m 



Yes 



Yes 


Bl 


Yes 

Yes 

D 


Yes 


CR 



Yes 

J 

Yes 

Yes 



— 

Yes 

Yes 

K 

Yes 

Yes 



— 


Yes 

L 


Yes 




Yes 

Yes 



Yes 





Yes 

KSillli 







Yes 

mm 







Yes 


^The QDECFMT system value determines the decimal point character (period in U.S. usage), the character used to 
separate groups of three digits (comma in U.S. usage), and the type of zero suppression (depending on comma 
and period placement). See the CPF Programmer's Guide for detailed instructions. 

^The Y edit code suppresses the leftmost zero of a date field that is three to six digits tong, and it suppresses the 
two leftmost zeros of a field that is seven positions long. The Y edit code also inserts slashes (/) between the 
month, day, and year according to the following pattern: 
nn/n 
nn/nn 
n/nn/n 
nn/nn/nn 
nnn/nn/nn 

If the DATE keyword is specified with EDTCDE(Y), the separator character used is the system value, QDATSEP. 
The slash (/) is the default QDATSEP. If QDATFMT is JUL (Julian), the data is normally formatted as: nn/nnn. 
^The Z edit code removes the sign (plus or minus) from a numeric field. The sign of the units position is changed 
to a hexadecimal F before the field is written. 
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User-Defined Edit Codes: You can also specify any of five user-defined edit 
codes (5 through 9). Before creating a display file from DDS source containing 
user-defined edit codes, the user-defined edit codes must exist. When 
creating the display file, the editing information is extracted from the 
user-defined edit codes as referenced in the DDS. Changing user-defined edit 
codes does not affect existing display files unless the display files are 
re-created. See the CPF Programmer's Guide and the CL Reference Manuai for 
a description of how to create user-defined edit codes if those shipped with 
the system cannot be used. 


Asterisk Fiil and Fioating Currency Symboi: You can optionally specify asterisk 
fill or floating currency symbol with edit codes 1 through 4, A through D, and J 
through M. 

When you specify asterisk fill, an asterisk (*) is printed for each zero that is 
suppressed. A complete field of asterisks is printed for a zero balance field. 

When you specify floating currency symbol, the symbol appears to the left of 
the first significant digit. The symbol does not print on a zero balance when an 
edit code is used that suppresses the zero balance. (The symbol that you 
specify must match the system value for the floating currency symboi. The 
symboi must match when the file is created; it does not have to match when 
the file is used.) 

Note: If an edit code is changed after a file is created, the editing specified at 
the time the file was created is used. The new edit code is not used unless 
the file is re-created. 

Figure 4-6 shows edit codes, unedited source data, and edited output. Zero 
suppression and decimal characters are determined by the system value 
QDECFMT. The date separator character is determined by the system value 
QDATSEP. In this figure, QDECFMT is assumed to equal b (blank), and 
QDATSEP is assumed to equal /. 


f 


I 
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Edit Codes 

Positive 

Number- 

Two 

Decimal 

Positions 

Positive 

Number- 

No 

Decimal 

Positions 

Negative 

Number- 

Three 

Decimal 

Positions 

Negative 

Number- 

No 

Decimal 

Positions 

Zero 

Balance- 

Two 

Decimal 

Positions^ 

Zero Balance- 
No Decimal 

Positions^ 


1234567 

1234567 

6666125- 

6666125- 

bfebfebb 


1 

12,345.67 

1,234,567 

.125 

125 

.00 

0 

2 



.125 

125 



3 



.125 

125 

.00 

0 

4 


WBBBl 

.125 

125 



A 

12,345.67 


.125CR 

125CR 

.00 

0 

B 

12,345.67 


.125CR 

125CR 



C 

12345.67 

1234567 

.125CR 

125CR 

.00 

0 

D 

12345.67 

1234567 

.125CR 

125CR 



J 

12,345.67 


.125- 

125- 

.00 

0 

K 

12,345.67 


.125- 

125- 



L 

12345.67 

■HBI 

.125- 

125- 

.00 

0 

M 

12345.67 

1234567 

.125- 

125- 



Y 3 

123/45/67 

123/45/67 

0/01/25 


0/00/00 

0/00/00 


1234567 

1234567 

125 

125 



^The 6 represents a blank. 

^This is an example of a signed numeric field. For all other data types, the negative number would be displayed as 
00012N whether decimal positions are specified or not, and the zero balanced field would appear as 000000 
(whether decimal positions are specified or not). 

^The Y edit code suppresses the leftmost zero of a date field that is three to six digits long, and it suppresses the 
two leftmost zeros of a field that is seven positions long. For more information, see the description of this edit 
code under CPF Edit Codes in this chapter. 

^The Z edit code removes the sign (plus or minus) from a numeric field and suppresses leading zeros of a numeric 
field. 


Figure 4-6. Valid Edit Codes, Source Data, and Edited Output 
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The following example shows how to specify the EDTCDE keyword: 




Conditioning 

Name Type (B/R/K/S/0) 

•u 

1 

S 

ir 

18 

^ 1 

Name 

19 20 21 22 23 24 25 26 27 28 

CO Reference (R) 

Length 

30 31 32 33 34 

1 

z 

> 

X 

w 

< 

m 

< 

Q 

35 

i| 

11 
36 37 

S 

I 

m 

Q 

S) 

5 

38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

E 

i£ 

6 

'J And/Or/Comment (A/0/*) 

z 

o 

z 

8 

Condition Name 

1 

2 

.8 

9 10 

z 

1 

2 

S 

1 

12 13 

Z 

o 

z 

14 

1 

5 16 

Line 

39 40 41 

Pos 

42 43 44 


A 




_J 

1 

_J 







mm 






B 







iO 

emcmecj) 

















A 




n 

1 







mm 






M i 7 



2 



n 


EDTCDECK . 

















- 

- 

- 

j 

1 


- 


-ami 

- 



- 

- 

- 

- 

- 

s 

- 

3 

- 


io 

micoed .. _ 

— 

— 

- 4-4 


— 

_ 

— 

— 

— 

— 

— 

— 

— 

— 

- 


In this example, the display length for PRICE Is 7 because the J edit 
code is specified, causing the field to contain a decimal point and an 
ending minus sign. It is edited as: 


ddd.dd- 

where d represents a digit. 

The display length for SALES is 11 because the K edit code and 
floating currency symbol are specified. It Is edited as: 

$dd,ddd.dd- 

The display length for SALARY is 10 because the edit code 1 is 
specified with asterisk fill, it is edited as: 


ddd,ddd.dd 
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EDTWRD('edit-word') 


If you cannot accomplish the desired editing by using the EDTCDE keyword, 
you can specify an edit word instead. An edit word specifies the form in which 
the field values are to be displayed and clarifies the data by inserting 
characters directly, such as decimal points, commas, floating and fixed 
currency symbol, and credit balance indicators. The edit word can also be used 
to suppress leading zeros and to provide asterisk fill protection. 


Option indicators are not valid with this keyword. 


Use the following rules to specify a valid edit word: 


• The EDTWRD keyword is valid for numeric only fields (Y specified in 
position 35). 

• You cannot specify both EDTWRD and EDTCDE for the same field. 

• Enclose the edit word in apostrophes. 

• The sum of the blanks and stop-zero-suppression characters (digit 
positions) in the edit word mus»t equal the length of the field. 

• When using the floating currency symbol, the number of digit positions 
contained in the edit word must be equal to the number of positions in the 
field to be edited. The currency symbol is not counted as a digit position. 
For example, if you specify a field length of 7 with 2 decimal positions, the 
edit word must be specified as: 

EDTWRDCb b b b$o.b b') 

where the b character represents a blank. 

• Any displayable character is valid, but the following characters in certain 
positions have special meanings: 

- Blank: A blank is replaced with the character from the corresponding 
position of the data field. A blank position is referred to as a digit 
position. 


- Ampersand: An ampersand causes a blank in the edited field. The 
ampersand is not displayed. Note that ampersands specified in the edit 
word between blanks can result in Invalid data when specified for an 
output/input field. This is because embedded blanks in a numeric-only 
field are converted to zeros. For example, if 

EDTWRDI'bb&bb&bb&LATER') is specified for an output/input field, 
and the work station user changes the displayed field, CPF converts the 
first two ampersands to zeros and displays an error message (too many 
digits) when the work station user presses the Enter/Rec Adv key. 


Initial Data 

in Program Displayed Field 


User Change 
to Field 


Data after 
Conversion 


060181 


06 01 81 LATER 07 01 81 LATER 07001081 
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- Zero: A zero stops zero suppression; place it in the rightmost position 
where zero suppression is to stop. The zero is replaced with the 
character from the corresponding position of the data field, unless that 
character is a zero. Any zeros in the data that appear to the right of the 
stop-zero-suppression character are displayed. The 
stop-zero-suppression character is considered a digit position. At least 
one leading zero is suppressed. Each zero that is suppressed is replaced 
by a blank. 

- Asterisk: An asterisk stops zero suppression and replaces zeros with 
asterisks (asterisk protection). Place the asterisk in the rightmost position 
where zero suppression is to stop. Each zero that is suppressed is 
replaced by an asterisk. 

An asterisk preceding a zero is interpreted as representing asterisk 
protection, and in this case, the zero prints as a constant. Any asterisks 
or zeros to the right of the stop-zero-suppression character are 
constants. 

- Currency Symbol: A currency symbol coded immediately to the left of the 
zero suppression code causes the insertion of a currency symbol in the 
position to the left of the first significant digit. It is called the floating 
currency symbol when used in this manner. 

A currency symbol coded in the leftmost position of the edit word is 
fixed and prints in the same location each time. When used in this 
manner, it is called the fixed currency symbol. 

The currency symbol is not considered a digit replace position. This 
symbol must correspond to the system value QCURSYM. 

- Decimals and Commas: Decimals and commas are printed in the same 
relative positions in which they are coded in the data unless they are 

to the left of the first significant digit. In that case, they are blanked out 
or replaced by an asterisk. 

- All Other Characters: All other characters are printed if they are to the 
right of significant digits in the data field. If they are to the left of the 
high-order significant digits in the data word, they are blanked out or 
replaced by asterisks if asterisk protection is being used. 

• If you want to show a negative sign with a negative number, include a sign 

in the edit word. Use either the minus sign (-) or the letters CR (credit). 

These print only if the number is negative. 
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Figure 4-7 shows sample edit words with the program value of the field and 
the display value of the field (as edited): 
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Edit Word 


$ 


$ 

$ 

$0 


0 

& > 


^ 0 


0* 

0 

$0. 

0 

0 


$0 

$0 




&c 


$0 

$0 

DOll 


crM* 

I 

a-^GRClSS' 

&- 


ET 


-&HET* 
&NET 
CR^ 

CR^ 

R 
R 


CR 

^CR 

LAR 


&CR^^4MET 

ScCR^&h^ET 


IS 


CENTS 


Program Value 


0000000005- 

OOOOOOOOOB'i* 

0034567890- 

0000000000 

1234567890- 

0000135792 

0000135792 

0000135792- 

0000000000 

0000135678+ 

0000135678- 

0000135678- 

0000135678+ 

0000135678+ 

0000135678- 

0000135678 

0000135678- 

1234567809- 

0000000000 - 

0000000000 - 

0000135678- 

0000135678- 

0000135678 

0000000005 

0001356789- 

0000135678+ 

0000135678 

095140036 

013579 

093076 

093076 

100176 


)$34l5,6| 

$ 

$ 1|2,3|45, 


oodi 

000 


Displayed As 




01 

01 


36> 


00 |' 

$ 

$ 

$ oil 


13[ 

1 

13 

1013 


95 

9- 

9 

llO/li 


35 

35 


(5678 

678 

5678 

5678 


1 
1 
1001 
$1 
1345 


$12 

^^00 


1 
1 

$1 
1 

-14 
130 


30-76 


30 


01/76 


33 


0 |! 
$ 0 . 
78. 

678 

7.9 


792 

792. 


356 

356 

356 

356 

678 




1013156 
,35| 


,35 


13,5 

,35 

,35 

-00 

,579 


76 


5 

05 

90qR^4 
00 
.901 
12 


78 

78 

78 

78 

09 

^ C 

0 C 


7b 


b.7^ 


06 


LATER 

LATER 


h 

h h 

NET 

ICR^ 


ET 

ET 


$. 

167 


GROSS 


8 

05 

89 qi 

8* 

•|6D0LLA|RS7|8CE| 




NET 

NET 


NTS 


Note: An execution time error can occur if this edit word is specified for a both field. 
See the description of ampersands earlier in this keyword description. 


Figure 4-7. Sample Edit Words 
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The following example shows how to specify the EDTWRD keyword 







ERASE(r6Cord-name-1 [record-name-2 ...[record-name-20]]) 
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Use this record level keyword with the OVERLAY keyword to specify that the 
records whose names you supplied as parameter values are to be erased from 
the screen when this record is written. The ERASE keyword may be specified 
more than once. 

The OVERLAY keyword must be specified when the ERASE keyword is 
specified. 

If ERASE and CLRL are both In effect on an output operation, the records 
specified in the ERASE keyword are erased despite the CLRL keyword. 

A record already on the display that has no input-capable fields and that has 
CLRL specified cannot be erased by the ERASE keyword on another record 
(the ERASE keyword has no effect). 

If the specified record is not on the screen, this function is ignored for that 
record name. 

Option indicators are valid with this keyword. 

Note: This function requires extra data transmission and should be used with 
discretion. 

The following example shows how to specify the ERASE keyword: 





Conditioning 

2 Name Type (ti/R/K/S/0) I 

oo Reserved I 

19 20 21 

Name 

22 23 24 25 26 27 28 

S Reference (R) 

Length 

30 31 32 33 34 

1 

2 

> 

X 

< 

m 

w 

< 

A 

1 

I— 

o 

35 

« Decimal 

Sj Positions 

s 

I 

m 

O 

I 

5 

D 

38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

12 3 4 

5 

& 

1 

u. 

6 

1 

1 

E 

<3 

6 

1 

7 

2 

Z 

8 

Condition Name 

^ Indicator 
o 

2 

o 

2 

11 

b 

i 

c 

12 13 

2 

1 

14 

1 

1 

15 16 

Line 

39 40 41 

Pos 

42 43 44 












g 


1 

r 










J 




















a 

1 











< 







J 




1 


















x: 

j 

Q 

■ 

1 

1 

1 

■ 

Hi 

■ 

■ 

1 

■ 


I 

i 

bh 


B 

■ 


BBI 


■ 


HH 

HH 

■ 

1 

BBBBBBBM 



1 

HHHHHHH 




HHHI 


■ 



HI 

1 

Q 



1 

1 

1 

H 

1 

1 

1 

1 


1 

1 

1 

■ 


■ 

■ 


bhi 


■ 


MB 

HI 

1 

1 

HHHHH 



■ 

BBBBBMBBBB 




HHH 







D 


1 





_ 







■ 


1 


1— 


■ 


HI 

HH 


ffjrrayyiiiH 




HHHHHHH 




BBBBB 





x: 


A 



1 

1 

■ 

■ 

■ 

1 

1 

■ 


m 

1 

B 


B 




bhh 


■ 


HI 

HH 

1 

1 

BBBBBBBIM 




HHHHHHH 




^HHH 








D 






j 




1 


II 

1 

B 


■ 




bhh 


■ 


HI 

BM 

1 

1 

HIHHHH 




BBBBBMBBBB 




HHH 








D 





■ 


1 

1 

1 

■ 


u 

1 

B 






BBI 


■ 


MB 

HH 

1 

1 

bhhhh 




HHHHHHH 




HHH 






r 


□ 













i 

B 




Bi^B 


■ 


HH 

HH 

7 

BHMHnBBBB 




HHHI^HHi 




HHH 





_ 


J 

B 











■ 

1 

B1 

■ 




HHH 


■ 


HI 

HI 

13 

msmsm 








IHHH 







B 












1 

B 

1 

■ 




bhi 


■ 


HI 

HI 

1 

1 

BBBBBBMB 








HHH 








n 

n 

m 




r 

n 


n 

nr 



n 

m 

r 

n 

n 

i 

n 

m 

n 

run 


r 











n 
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ERASEINPf r *MDT0 n11 

L\*all ;j 

Use this record level keyword with the OVERLAY keyword to erase 
unprotected input-capable fields already on the screen. The fields are erased 
before the record format you are defining is displayed. Input-capable fields in 
the record format you are defining are not erased. 

To erase all input-capable fields already on the screen, specify the *ALL 
parameter. To erase only input-capable fields that have their modified data 
tags (MDTs) set on, specify the *MDTON parameter. Specifying the 
ERASEINP(*MDTON) or the ERASEINP keyword has the same effect as 
pressing the Erase Input key on the 5250 work station keyboard. 

On the system console, the ERASEINP(*MDTON) keyword is treated as the 
ERASEINP(*ALL) keyword. 

The OVERLAY keyword must be specified when the ERASEINP keyword is 
specified. 

Unprotected input-capable fields are fields for which the DSPATR(PR) keyword 
is not in effect. 

When the MDTOFF keyword is specified on the same record format as the 
ERASEINP keyword, two conditions can occur: 

• ERASEINP(*ALL) Implies MDTOFF(*UNPR) unless MDTOFF(*ALL) is 
specified. 

. If ERASEINP or ERASEINP(*MDTON) is specified with MDTOFF(*ALL), the 
end effect is as if ERASEINP(*ALL) and MDTOFF(*ALL) are both specified. 

If ERASEINP and PROTECT are both in effect for an output operation, CPF 
first erases the input-capable fields specified on the ERASEINP parameter 
value, then protects all input-capable fields on the display from input keying. 

Option indicators are valid with this keyword. 
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The following example shows how to specify the ERAS El NP keyword: 
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0“ 


Conditioning 

Name 

c 

18 19 20 21 22 23 24 26 26 27 28 

S Reference (R) 

Length 

30 31 32 33 34 

S? Data Type (k> A/P/S/B A/S/X/Y/N/l/W) I 

^ Decimal 

Positions 

8U$age(l4/0/l/8/H/M) 

Location 

Functions 

46 46 47 48 46 60 51 62 53 64 55 66 67 58 69 60 61 62 63 64 65 86 67 08 09 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 6 

* Form Type 

I 

1 

1 

7 

z 

i 

Condition Name 

p 

1 

1 

9 10 

z 

i 

11 

12 13 

z 

1 

14 

^ indicator 

:: Name Type (D/R/K/S 

Une 

39 40 41 

Pos 

42 43 44 

7ESE 

D 


1 





■1 

IHHHH 















Q 

15 

1 





■■ 

IHHHH 














•EEEE 

□ 


1 





■I 

IHHHH 





■ 

a 

1 

HH 

HH 


1 

1 

1 


13 







Hi[^ 


a 
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ERRMSG('message-text' [response-indicator]) 

ERRMSGID(msgid msg-file[.library-name]) 

Use one of these field level keywords to identify a message to be displayed on 
the message line and associated with this field. 


ERRMSG Keyword: For ERRMSG, the parameters specify the message text 
and, optionally, a response indicator. The message text is the message to be 
displayed. (The Help key is not supported and if pressed causes ah error 
message to be sent to the display.) 

If you specify a response indicator, it should be the same as the option 
indicator used to condition the ERRMSG keyword. On the input operation that 
follows the display of the error message, CPF turns off the indicator. If the 
response and the option indicators are the same, they are both turned off. One 
exception to this rule is if the response indicator is also specified for another 
keyword such as CHANGE, CAnn, or CFnn. In that case, the on/off setting of 
the response indicator is based on the results of the function provided by the 
CHANGE or CFnn keyword. When a response indicator is specified, the first 
50 characters of the message are also used as indicator text. Separate 
response indicator text is not valid for the ERRMSG keyword. 


ERRMSGID Keyword: For ERRMSGID, the parameters specify the message 
identifier for the message to be displayed and its message file. The message 
to be displayed is retrieved from the message file during program execution. 
(The Help key is supported for this keyword and if pressed causes a 
predefined second-level message from the message file to be displayed if it 
exists.) The message file can optionally be qualified by a library name. 

Note: The message file used in ERRMSGID must exist in the specified library. 
The work station user must have operational rights to the message file at 
program execution time. 

The following example shows how to specify the ERRMSG and ERRMSGID 
keywords: 
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Priority Among Setected Keywords: You can specify ERRMSG and ERRMSGID 
more than once for a single field. During program execution, use option 
indicators to select a particular message to be displayed. 

Only one message can be displayed at one time even if messages are in effect 
for several fields on the same output operation. The field whose message is 
displayed is the first field for which the program selected a message. 

If several keywords are in effect for one field on an output operation, the 
message to be displayed is the first of the following: 

1. ERRMSG (If more than one ERRMSG keyword is selected, the first one 
the program selects is displayed.) 

2. ERRMSGID (If more than one ERRMSGID keyword is selected, the first 
one the program selects is displayed.) 

A message field is displayed only if no error message keywords are also to be 
displayed. 

For a list of priorities including SFLMSG and SFLMSGID, see Priority Among 
Seiected Keywords in the SFLMSG/SFLMSGID keyword description later in this 
chapter. 
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Conditions Occurring During Message Dispiay: The displaying of a message 
using ERRMSG and ERRMSGID is similar to the displaying of messages by 
CPF when field validation errors are detected. 

When a message is displayed because of either the ERRMSG or the 
ERRMSGID keyword, all fields on the screen are retained, including the field 
the message is associated with. Except for option indicators, data in the 
output buffer is Ignored (that Is, any new data from the program is not sent to 
the display). 

The command keys valid following display of a message are: 

• Command keys specified at the file level. 

• Command keys specified for the record format for which a message is 
displayed, if selected when the message is displayed. 

When the message is displayed on the 5250 work station, the following 
conditions occur: 

• For all errors: 

- The message is highlighted. 

- The cursor is blinked and the keyboard locked until the work station user 
presses the Reset key. 

• For errors associated with input-capable fields: 

- All fields In error are displayed with their Images reversed. (If a field in 
error has both the underline (UL) display attribute and the highlight 
attribute (HI), its image is not reversed.) 

- The cursor is repositioned to the first displayed field that is in error. 

• For errors associated with output-only fields: 

- The display attribute of the field is not changed. 

- The cursor is not positioned to the field (it does not change position). 

When the message is displayed on the system console, the following 
conditions occur: 

• The cursor is repositioned to the associated field. 

• The message appears without special display attributes. 
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Restoration of Reversed Image Fields: Fields on the 5250 work stations are 
displayed with their images reversed because of system-detected keying errors 
or because of the ERRMSG or the ERRMSGID keyword. Generally, CPF 
restores the image on the next I/O operation to the display, and that is usually 
the next request from your program. The restoration is done before the 
requested function is performed. The following are exceptions where requests 
from your program do not cause CPF to restore reversed image fields: 

• An input request with cancel (canceling a get operation with NOWAIT) 

• A close request when the KEEP keyword is In effect 

• Any request to a subfile record (no data is sent to the device) 

• An output operation to a subfile control record format that does not display 
the subfile control record or subfile records (for example, clearing, deleting, 
or initializing the subfile) 


Priority Among Selected Keywords: For a description of which message is 
displayed when more than one error message or subfile message keyword is 
selected, see Priority Among Selected Keywords in the SFLMSG/SFLMSGID 
keyword description. 


Restrictions and Notes 

1. If ERRMSG or ERRMSGID is in effect, no record or field processing is 
performed other than that defined for these keywords. If neither keyword 
is in effect, the record is processed in the normal manner. 

2. ERRMSG and ERRMSGID are valid for output-only. Input-only, or 
output/input fields. ERRMSG and ERRMSGID cannot be specified for a 
constant, hidden, or message field. 

3. For input-capable fields, ERRMSG and ERRMSGID are In effect only if 
the field for which they are specified is already on the screen. 

4. ERRMSG and ERRMSGID cannot be specified in a subfile record format 
(SFL keyword specified). To display error messages for a subfile, see the 
SFLMSG and SFLMSGID keywords. 

5. ERRMSG and ERRMSGID are ignored if the variable start line number 
(SLNO(*VAR) specified) has changed since the last output operation. 
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GETRETAIN GETRETAIIM 

Use this record level keyword with the UNLOCK keyword to specify that CPF 
is not to erase input-capable fields on input operations as described under the 
UNLOCK keyword. 

You must specify the UNLOCK keyword without any parameters before 
specifying the GETRETAIN keyword. The UNLOCK(*MDTOFF) specification 
provides the same function as the GETRETAIN keyword. See the UNLOCK 
keyword for additional details. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the GETRETAIN keyword: 
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HELP[(response-indicator ['text'])] 
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Use this file or record level keyword to specify that you want to recognize and 
handle the Help key through your program rather than have CPF issue an error 
message to the user indicating that the Help key is invalid at that time. 

The Help key functions as a command attention key (no data is received from 
the display). 

Control does not return to your program if either of the following is true: 

• An error message is displayed. 

• A message subfile is displayed and the cursor is positioned in it. 

Note: On the system console, if the cursor is positioned within the error 
message, the Help key displays the second-level text of the system message, 
not the second-level text of the program-generated message. 

The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters in the program listing. 

One use of this keyword is to specify the same indicator as the response 
indicator for the HELP keyword and as an option Indicator on a message field. 
When the user presses the Help key, the Indicator is turned on and control 
returns to the program. The program can then issue another put operation to 
the record format on the screen; with the indicator on, the message is 
displayed on the message line. 

A second use of this keyword is to save any keyed input and display help text 
on a new display. 

Option indicators are valid with this keyword. 

The following example shows how to specify the HELP keyword: 
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HOME[(response-mdicator ['text'])] 

Use this file or record level keyword to specify that you want to recognize and 
handle the Home key through your program. 

If the work station user presses the Home key and the cursor is not already at 
the home position, the cursor returns to the home position, whether the HOME 
keyword is specified or not. 

If the cursor is already at the home position when the Home key is pressed, 
CPF returns control to your program as it does when a command attention key 
is pressed (no data is received from the device). In this situation, if you have 
not specified the HOME keyword, CPF issues a message indicating that the 
key is invalid at that time. 

The home position is one of the following (in order of priority): 

• The cursor position specified by the last output operatiorv 

• The first unprotected input field 

• Position 1, line 1 

The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 

Option indicators are valid with this keyword. 

The following example shows how to specify the HOME keyword so that if the 
cursor is in the home position, when the Home key is pressed control returns 
to the program with response indicator 95 set on: 
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Use this file, record and field level keyword to associate descriptive text 
(indicating intent or usage) to a specific response or option indicator. You can 
specify it once for each response and option indicator. 

If you specify this keyword, indicator usage text is a required parameter value 
and must be a character literal enclosed in apostrophes. 

The text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file nor the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 

Option indicators are not valid with this keyword. 

Note: The INDTXT keyword does not by itself cause the specified indicator to 
appear in either the input or the output record area. It merely provides text to 
be associated with the indicator. If the indicator has not been specified 
elsewhere (as either an option indicator or a response indicator), then the text 
is lost without a diagnostic. Also, once an indicator has been given a text 
assignment (either by this keyword or the response indicator text), no other 
text assignment is allowed. 

The following example shows how to specify the INDTXT keyword: 
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INZRCD 

Use this record level keyword (initialize record) to specify that if this record is 
not already on the screen, it is to be written to the screen before an input 
operation is issued from the program specifying this record name. Tf this 
record is already on the screen, the keyword is ignored. This implicit output 
operation, when performed, is CPF-initiated; its purpose is only to format the 
screen when an input operation is performed. Option indicators are not valid. 

This keyword does not apply to output operations. 

The following example shows how to specify the INZRCD keyword: 
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If INZRCD is not specified, your program is given an error if it tries to read a 

record when that record is not on the screen. 

When the INZRCD keyword is processed, the following special conditions 

exist: 

• For output-only fields, no user data is available. The field appears on the 
screen as blanks. Any editing specified is ignored. The BLKFOLD keyword 
does not affect the screen. 

• For output/input fields, no user data is available. The field appears on the 
screen as blanks. Any editing specified is ignored. The input save area is 
initialized in the same way as uninitialized input-only fields (blanks or zeros, 
depending on the data type). 

• Constants and input-only fields appear the same as when displayed using 
an explicit output operation. 

• Hidden fields are returned on a input operation as blanks or zeros. 

• Message fields are ignored; there is no message data. 

• The LOGOUT keyword is ignored because there is no output buffer to log. 

• The ERRMSG and ERRMSGID keywords are ignored because the record is 
not already on the screen. 

• The SFLMSG and SFLMSGID keywords are ignored. 

• All other optioned keywords and fields are processed as if they were 
optioned. 

Note: Your program must specify a record format name when issuing an input 

operation that contains this keyword for the INZRCD function to be performed. 
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KEEP 


Use this record level keyword to keep the screen from being erased when the 
display file is closed. The entire screen is kept if any of the records on the 
screen have the KEEP keyword specified; the default causes the entire screen 
to be erased when the file is closed. 

In addition, the name of the first uppermost record on the screen that has the 
KEEP attribute is saved by CPF for possible use by subsequent programs. The 
name that is kept can be used by a subsequent program that does not specify 
a record name on its first input operation. This keyword enables you to leave 
data on the screen for review after your program terminates, or you can use 
that data as input for subsequent programs. For additional consideratlar,s for 
this keyword, see the CPF Programmer's Guide. 

Option and response indicators are not valid with this keyword. 

The following example shows how to specify the KEEP keyword: 
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LOCK 


This record level keyword is used to specify that the keyboard is to remain 
locked after an output operation. Normally, the keyboard is automatically 
unlocked after an output operation. 

The LOCK keyword is used when there are several consecutive output 
operations that contain input fields. If this keyword is not specified, the work 
station user could key data into a field when a subsequent output operation 
sends data to the screen. In this case, the cursor location can be changed and 
the key entry data lost. 

If one program performs an output operation that unlocks the keyboard and a 
subsequent program attempts to open a different display file, the request to 
open that file is not accepted by data management. (See the CPF 
Programmer's Guide for additional considerations.) 

Note: The default on an output operation is to unlock the keyboard. If the 
keyboard is locked when an input operation is issued, it is automatically 
unlocked. 

This keyword is independent of other keywords that affect the output 
operation. 

Option indicators are valid with this keyword. 

The following example shows how to specify the LOCK keyword: 
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LOGINP 


Use this record level keyword to specify that the input buffer for this record 
format is to be written to the job log each time CPF performs an input 
operation for the record. The data logged includes the values of input-capable 
fields, hidden fields, and response indicators specified in the record format you 
are defining. The function of this keyword is for debugging and other 
exception conditions. The job log cannot be read by your program. 

CPF ignores LOGINP if there are no input-capable or hidden fields or if there 
are no response indicators in the record format. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the LOGINP keyword: 
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LOGOUT 


Use this record level keyword to specify that the output buffer for this record 
format is to be written to the job log each time CPF performs an output 
operation for the record. The data logged includes the values of 
output-capable fields, hidden fields, and option indicators specified in the 
record format you are defining. The function of the LOGOUT keyword is for 
debugging and other exception conditions. The job log cannot be read by your 
program. 

CPF ignores the LOGOUT keyword if there are no output-capable or hidden 
fields, and if there are no option indicators in the record format. 

Option indicators are valid with this keyword. 

The following example shows how to specify the LOGOUT keyword: 
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LOWER 

The LOWER keyword is equivalent to the CHECK(LC) keyword. The CHECK 
keyword is preferred because it is compatible with DOS on other systems. See 
Keyboard Control in the CHECK keyword description for an explanation of how 
to use this keyword. 
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MDTOFF 



Use this record level keyword with the OVERLAY keyword to set off modified 
data tags (MDTs) for input-capable fields in record formats already on the 
screen. The MDTs are set off when your program issues an output operation 
to the record format you are defining. To set off MDTs for unprotected fields 
only (those without DSPATR(PR) in effect), specify the *UNPR parameter value 
(this is also the default if no parameter value is specified). To set off MDTs for 
all input-capable fields, specify the *ALL parameter value. 

Your program can select DSPATR(MDT) for fields in the same record format 
for which it selects MDTOFF (any parameter). If so, these fields are displayed 
with their MDTs set on. 

On the system console, the MDTOFF(*UNPR) keyword is treated as the 
MDTOFF(*ALL) keyword. 

ERASEINP(*ALL) Implies MDTOFF(*UNPR) unless MDTOFF(*ALL) Is specified. 

If ERASEINP(*MDTON) is specified with MDTOFF(*ALL), the end effect is as If 
ERASEINP(*ALL) and MDTOFF(*ALL) are both specified. This is also true if 
ERASEINP is specified with no parameter value. 

Option indicators are valid with this keyword. 

The MDTOFF keyword is not valid for the subfile record format (identified by 
the SFL keyword); it is valid for all other record formats for which OVERLAY is 
also specified. 
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The following example shows how to specify MDTOFF keyword: 
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In this example, RECORD1 and RECORD2 have equivalent MDTOFF 
specifications. When RECORD1 or RECORD2 is displayed, the MDT of 
each input-capable field already on the screen is set off, unless the 
field has the DSPATR(PR) keyword in effect (FLD33, when displayed, 
is such a field). 

When REC0RD3 is displayed, the MDTs of each input-capable field 
already on the screen is set off even if DSPATR(PR) is in effect for the 
field. 
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MSGLOC(line-number) 

Use this file level keyword to move the message line to the specified line 
number. If MSGLOC is not specified, the message line is the last line of the 
display screen. The message line is the display location for the following 
messages: 

• Validity check errors 

• Invalid function keys 

• Messages defined as parameter values for the ERRMSG and SFLMSG 
keywords 

• First-level text for messages identified by the ERRMSGID and SFLMSGID 
keywords (second-level text requires the entire screen) 

• Message fields 

• Operator error codes and their associated messages (5250 work stations 
only) 

The MSGLOC specification is in effect continuously from file open to file close. 
It can be temporarily overridden if the file you are defining is suspended while 
another file is opened to the same work station device. The message location 
in effect for the other file is used until the file you are defining is restored. See 
the section on using record formats in different display files in the CPF 
Programmer's Guide. 

The parameter value is required and can be any one- or two-digit number in 
the range of 1 through 24. The number must not be greater than the maximum 
line number for the screen size being used. Screen size condition names must 
be specified if message lines for secondary screen sizes are to be different 
from the last line of the display screen. 

Option indicators are not valid with this keyword. 

On the 5250 work stations, any data on the message line before the message 
appears is saved and restored after the Reset key is pressed. 

On the system console, any data displayed on the message line before the 
message appears is erased when the message appears. Pressing the Reset key 
does not restore the original data. It is recommended that fields not be defined 
to appear on the message line for the system console. 
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The following example shows how to specify the MSGLOC keyword 
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OPENPRT 

Use this file level keyword to specify that once the printer file is opened (first 
time the user presses the Print key [on the 5250 work station] or the CF24 
key [on the system console]), it is to remain open until the associated display 
file is closed. If you do not specify OPENPRT (and the PRINT keyword is 
specified), the printer file is opened and closed each time a screen image is 
printed. 

The printer file should be spooled if more than one job uses the same printer 
file and device. While the printer file is open in the nonspooled mode, the 
associated printer is allocated to the program or process using this function. 

This keyword is valid only if you have specified the PRINT keyword. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the OPENPRT keyword: 
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OVERLAY 


Use this record level keyword to specify that the record format you are 
defining should appear on the display without the entire display being erased 
first. Normally, the entire display is erased on each output operation. All 
records on the display with fields that partially or completely overlap fields in 
this record are erased before this record is displayed; all others remain on the 
display and are not modified in any way. (A record already on the display is 
erased even if fields specified in the record format are not selected for display.) 
For example, assume that the following records are on the display: 


REC1 (lines 1 and 2) 
REC2 (lines 3 and 4) 
REC3 (line 5) 

REC4 (line 9) 


An output of REC5 (lines 4 and 5) with OVERLAY would leave the display with 
the following records: 

REC1 (lines 1 and 2) 

REC5 (lines 4 and 5) 

REC4 (line 9) 


If the record with OVERLAY in effect is already on the display and PUTOVR, 
PUTRETAIN, or CLRL is not specified, it is erased and rewritten as a new 
record. 

When the beginning attribute character of a record overlaps the ending 
attribute character of a record already displayed, the record already displayed is 
erased unless the attribute characters overlap each other in position 1 of a line. 
(The last field of the first record displayed ends in the rightmost display 
position of the preceding line.) 

In the above example, however, if the only portion of REC2 on line 4 is the 
ending attribute character of the last field of REC2 (which occurs when the last 
displayed character of the last field of REC2 is in the last position of line 3), 
REC2 remains displayed following the display of REC5 with OVERLAY. The 
display would have the following records: 

REC1 (lines 1 and 2) 

REC2 (Iine3) 

REC5 (lines 4 and 5) 

REC9 (line 9) 

The display is always erased on the first output operation after the file is 
opened, except when both ASSUME and OVERLAY are specified. 

OVERLAY is assumed by CPF for ERRMSG, ERRMSGID, PUTOVR, and CLRL 
functions. 
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To erase any of the records on the display, use the ERASE keyword to specify 
the names of the record formats to be erased. 


If you also specify the CLRL keyword, execution proceeds according to the 
CLRL specification, not the OVERLAY specification. 

If OVERLAY is conditioned and not selected, then ERASE, ERASEINP, 
MDTOFF, PROTECT, and PUTRETAIN cannot take effect if they are selected, 
unless PUTOVR is selected. In such cases, ERASE, ERASEINP, and MDTOFF 
can take effect. 

Option indicators are valid with this keyword. 

See the CPF Programmer's Guide for more information on the use of the 
OVERLAY keyword. 

The following example shows how to specify the OVERLAY keyword: 


F 



Conditioning 

oc 

a 

1 

1 

« Reserved 1 

Name 

19 20 21 22 23 24 25 26 27 28 

S Reference (R) 

Length 

30 31 32 33 34 

a Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

|l 

ll 

36 37 

^ Usage (tf/O/l/B/H/M) 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

» Form Type 

1 

1 

1 

i 

7 

Z 

z 

d 

Condition Name 

i 

\ 

9 

i • 

10 

z 

z 

1 

1 

12 13 

Z 

1 

14 

^ Indicator 

Line 

39 4041 

Pos 

42 43 44 

mm 

□ 












irMiOi 











D 

iviNKiai 







1 



□ 






■ 

■ 

1 

■1 

1 












n 

■ 


1 

■ 

HIHHi 

■1 

■ 

muHi 

■mill 



Q 






1 

■ 

■ 

■ 

■ 
























Q 



■ 

1 






1 
























D 










■ 






















B 

■ 

■ 




J- 



J 

J 











■ 

■MIW 

M 

■mn 

■ 

■ 


■WHHHI 


4-130 






















OVRATR 


Display Files 
OVRATR 


Use this field level keyword with the PUTOVR keyword to override the existing 
display attributes of a field already on the display. The OVRATR keyword can 
be used with the OVRDTA keyword on the same field. 

The display attributes that can be overridden by the OVRATR keyword are: 

CHECK(ER) 

CHECK(ME) 

DSPATR (all except OID and SP) 

DUP 

The OVRATR keyword is valid only with input-only, output-only, output/input, 
or constant fields. 

When the OVRDTA keyword is in effect, the display attribute can also be 
overridden on the same output operation (as If the OVRATR keyword were also 
in effect). 

Option indicators are valid with this keyword. 

For a discussion and example of how to use the OVRATR keyword, see the 
PUTOVR keyword description in this chapter. 


OVRDTA 

Use this field level keyword with the PUTOVR keyword to override the existing 
data contents of a field already on the display. The OVRDTA keyword can be 
used with the OVRATR keyword on the same field. 

The OVRDTA keyword is valid only with output-only, output/input, or message 
fields. 

The OVRDTA keyword is required If the DFT keyword is specified for 
output-only or output/input fields. 

Option indicators are valid with this keyword. 

For a discussion and example of how to use the OVRDTA keyword, see the 
PUTOVR keyword description In this chapter. 
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PASSRCD(record-format-name) 


Use this file level keyword to specify the record format to be used by CPF 
when unformatted data is passed to your program by another program. The 
passed data is processed only if the first request from your program after file 
open is an input operation without a record format name. The data must be 
processed according to this record format. (See the CPF Programmer's Guide 
for more information.) 

The record format name is a required parameter value for this keyword. 
Option indicators are not valid with this keyword. 

The following example shows how to specify the PASSRCD keyword: 
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PRINT[(response-indicator ['text']) | (device-file-name[.library-name])] 


Display Files 
PRINT 


Use this file level keyword to specify that the work station user can press the 
Print key (or, on the system console, the CF24 key) to print the current display. 

The following three examples illustrate the three ways of specifying the PRINT 
keyword: 

PRINT CPF prints on QSYSPRT. For the 5250 work 

station, you can specify another printer file on 
the Create Device Description (CRTDEVD) or 
Change Device Description (CHGDEVD) 
commands. See PRINT Keyword without 
Parameter Values later in this keyword 
description. 

PRINT(01 'User presses Print key') Your program is given control and decides 

what to do (for example, produce formatted 
printer output). The response indicator is set 
on. No data is sent from the device. (On the 
system console, the key labeled CF24 acts like 
CA24.) 

PRINT(PRINTFILEI.LIBI) CPF prints the display through the specified 

printer file (which can be described through 
DDS). An Override with Printer File (OVRPRTF) 
command, if in effect before the printer file is 
opened (when the Print key is pressed), can 
change the printer device name. 


Option indicators are valid with this keyword. 

Further considerations regarding the three ways of specifying the PRINT 
keyword are discussed in the following sections. 
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PRINT Keyword without Parameter Values 


For the Local 5250 Work Station: CPF attempts to print the screen image on 
the associated work station printer without sending the data through the 
system. Nondisplay fields appear as blanks; duplicated characters entered by 
pressing the Dup key appear as asterisks {^); screen attributes appear as 
blanks, if the print function cannot be performed successfully, CPF attempts to 
complete the print function, using the printer file specified on the PRTFILE 
parameter on the CRTDEVD or the CHGDEVD command used to describe the 
display device to the system. 

For work station printers attached through the work station controller, a 
message indicating that there is a problem is issued to the work station user 
requesting the print function. The work station user can make the printer ready 
or press the Reset key. To cancel a print request before it is complete, the 
work station user can press the shifted Print key. 

Note: After the current display is printed, the paper is advanced twice the 
number of lines as in the current screen size (24 lines for a 12 by 80 screen 
and 48 lines for a 24 by 80 screen). 


For the Remote 5250 Work Station: If the printer is not ready when the Print 
key is pressed, no specific message is sent to the user. The work station 
requesting the print function remains inoperable until the printer is made ready, 
or until the print request is canceled (by using the shifted Print key). 

Note: After the current display Is printed, the paper is advanced the same 
number of lines as In the current screen size (12 lines for a 12 by 80 
screen and 24 lines for a 24 by 80 screen). 


For the System Console: CPF opens QSYSPRT (a spooled output file), reads 
the screen buffer, and directs the screen image to QSYSPRT. The file is 
opened for each printer request and is closed when the print function is 
complete. 

The following example shows how to specify the PRINT keyword with no 
parameter values: 
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PRINT Keyword with Response Indicator 

If you specify the PRINT keyword with a response indicator, CPF returns 
control to your program with the specified response indicator set on. No data 
is received from the device. The keyboard on the 5250 work station is locked 
until your program issues another output operation to the display file. The 
keyboard on the system console is not locked. There is no difference in the 
print function between local and remote 5250 work stations. 

The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required, if you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 

The following example shows how to specify the PRINT keyword with a 
response indicator: 
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PRINT Keyword with a Printer File Specified 

CPF reads the screen buffer and prints the screen image using the specified 
printer file. The printer file that you specify as a parameter value for this 
keyword can be either an externally described or a program-described file. It 
also can be either spooled or nonspooled. If you specify an externally 
described printer file, it must contain a record format with the same name as 
the file. 

The printer file must exist and be authorized to the user of the display when 
the Print key is pressed. This also applies to the library name if it is specified. 

If CPF is unable to perform the print function on the specified printer file, CPF 
attempts to use the printer file specified on the PRTFILE parameter of the 
CRTDEVD or the CHGDEVD command. It Is recommended that SPOOU^YES) 
be specified on the CRTDEVD or the CHGDEVD command to prevent locking 
of the 5250 work station keyboard (the keyboard on the system console is not 
locked). 

If you do not specify the library name, the current library list is used. 

See the OPENPRT keyword for details of when the printer device file is opened 
and closed. 

The following example shows how to specify that the display is to be directed 
to printer file PRINTFILE1.LIB1: 
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Use this record level keyword with the OVERLAY keyword to specify that 
when the record you are defining is displayed, all input-capable fields already 
on the display are to be changed to output-only fields. This protects them 
from input keying. The data contents of the input-capable fields are not 
changed, but your program cannot read them unless it first redisplays the 
record formats in which the input-capable fields are specified. 

I To protect a single field from input keying, see the DSPATR(PR) keyword. 

The PROTECT keyword is valid only for the 5250 work station and is ignored 
for the system console. 

The OVERLAY keyword must be specified in the record format In which 
PROTECT is specified. Also, either the OVERLAY keyword or the CLRL 
keyword must be In effect for the PROTECT keyv\ford to be in effect. 

PROTECT is not in effect if PUTOVR is in effect. 

If the ERASEINP and PROTECT keywords are both in effect for an output 
operation, CPF first erases the input-capable fields specified on the ERASEINP 
parameter value, then protects all input-capable fields on the display from 
input keying. 

Option indicators are valid with the PROTECT keyword. 

The following example shows how to specify the PROTECT keyword: 
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In this example, RECORD1 has an input-capable field that has been 
displayed and read and that should be left on the display while 
RECORD2 is displayed and read. To prevent further keying into FLD1 
in RECORD1, issue an output operation to RECORD2 a second time 
with the PROTECT keyword in effect. Note that FLDA is not 
protected, but FLD1 is. 
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PUTOVR 


Use this record level keyword (put with explicit override) to permit the override 
of either display attributes or data contents (or both) of selected fields within a 
record displayed on a work station device. By using the PUTOVR keyword, you 
can reduce the amount of data sent to the display device. 

When selected fields in a record that has already been displayed are to be 
changed, an output or an output/input operation issued to the record with 
PUTOVR, OVRDTA, and OVRATR in effect changes only the fields for which 
OVRDTA or OVRATR is in effect. The OVRDTA keyword permits a change in 
the data contents of the field and the OVRATR keyword permits a change In 
the display attributes of the field. The way in which fields are to be changed is 
controlled by setting option indicators. 

Option Indicators are valid with the PUTOVR, OVRATR, and OVRDTA 
keywords. 

The following conditions cause the put-override keywords to be ignored and 
no error to occur: 

• PUTOVR is not in effect at the time of the output operation. 

• Both OVRDTA and OVRATR are not in effect at the time of the output 
operation. 

• The record Is not already on the screen. 

The PUTOVR and OVRDTA keywords must be specified when DFT is specified 
for a named output-capable field. When PUTOVR and OVRDTA are both in 
effect for a field, the default value specified with the DFT keyword is displayed 
only on the first display of the field. On subsequent displays with PUTOVR 
and OVRDTA in effect, the program value Is displayed. 

CPF assumes that, except for input-capable fields, all fields specified to be 
overridden are already displayed. This assumption differs from PUTRETAIN. 

The PUTRETAIN keyword and the put-override keywords are mutually 
exclusive within the same record format. 

The OVRDTA keyword is permitted only with output-only, input-only, 
output/input, or message fields (usage O, I, B, or M, respectively). 

The OVRATR keyword is permitted only with output-only, input-only, or 
output/input fields (usage 0, I, or B, respectively). 
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The OVRATR keyword can be used only to override the following display 
attributes: 

CHECK(ER) 

CHECK(ME) 

DUP 

DSPATR (all except OID and SP) 

An output operation with OVRDTA in effect does not need to have OVRATR in 
effect to override display attributes, as well as data contents, of the field or 
fields being overridden. 

For example, if a work station user has keyed data into input-capable fields 
but has not yet pressed the Enter/Rec Adv key, the program can change the 
display attributes or displayed data within certain fields of the display by 
issuing an output operation with the appropriate put-override keywords 
selected. 
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In this example, an initial output operation displays a full screen of 
information; on a second output operation, PUTOVR is in effect and the 
program can set option indicators to make the following changes to the 
display: 

• If option indicator 11 is set on, the constant 'Remaining on hand:' would 
be changed to a highlighted field. (The only way to reset the display 
attribute to normal is to redisplay the record format after erasing it.) 

• If option indicator 12 is set on, the program can change the displayed 
value of the field INVBAL 

• If option indicator 13 is set on, the program can set the value of the field 
SUPPLIER to override the default value {'INTERNAL'). 


If option indicator 14 is set on, the display attribute of the field 
ACCOUNT is changed from highlight to highlight and reverse image at 
the same time that new data is sent to the field. If option indicator 14 is 
set off, the display attribute is changed back to highlight. New data is 
sent to the display on each output operation. 
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Use this record or field level keyword with the OVERLAY keyword so that CPF 
does not erase data already on the screen when redisplaying a record. The 
PUTOVR keyword has a function similar to, but more effective than, this 
keyword. 

To understand what effect this keyword has on output operations, consider the 
following sequence of steps: 

1. Your program issues an output operation to RECORD1, displaying 
RECORD1. The PUTRETAIN keyword, if in effect. Is ignored. Any data in 
the record area for RECORD1 is erased before RECORD1 is displayed. 

2. At some later time, with RECORD 1 still on the screen, your program 
issues a second output operation to RECORD1. Two conditions can 
occur: 

• If the PUTRETAIN keyword is not in effect, CPF first erases the record 
area for RECORD1, then displays RECORD1. Fields selected for 
display at this time are displayed with new data contents and new 
display attributes, which can be the same as before. The record area 
includes every line on which a field or part of a field for RECORD1 
appears. 

• If the PUTRETAIN keyword is In effect, CPF does not erase the record 
area for RECORD1. The data contents of selected fields are not 
changed. However, the display attributes for selected fields are sent 
to the screen and can be changed (by selecting which DSPATR 
keyword is in effect for this output operation). Fields not selected for 
display are written over character by character by fields selected for 
display. For more information, see When Fields are Selected by 
Option Indicators later in this keyword description. 

Option indicators are valid with the PUTRETAIN keyword. 


Conditions Affecting the PUTRETAIN Keyword: The PUTRETAIN keyword 
applies only to the record format for which it is specified, and only if the 
record is already displayed on the screen. If the record on which the 
PUTRETAIN keyword is specified is not on the screen, the PUTRETAIN 
keyword is ignored. 

When specified at the record level, this keyword applies to all fields in the 
record format that have been selected for display. When specified at the field 
level, this keyword applies only to the fields for which it is specified. 

This keyword can be specified for more than one field of a record format, but 
only once per field. This keyword can be specified at the record level and at 
the field level within the same record format. 

The PUTRETAIN keyword cannot be specified with the PUTOVR keyword. 
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The OVERLAY keyword must be specified when the PUTRETAIN keyword is 
specified. 

If the OVERLAY keyword is not in effect the PUTRETAIN keyword is ignored 
and the entire screen erased before the record is displayed. 


When Fields are Selected by Option Indicators: When the PUTRETAIN keyword 
is in effect on an output operation involving field selection, fields In the record 
format that are not selected for redisplay are not erased from the screen; they 
can be partially or completely rewritten by newly selected fields. 

If PUTRETAIN is in effect only for a newly selected field (specified at the field 
level), only the beginning attribute character of the field is sent to the screen; 
the ending attribute character is not sent to the screen. (For fields without 
PUTRETAIN in the same record format CPF sends the display attribute and 
the data.) If the PUTRETAIN keyword is in effect for the whole record 
(specified at the record level), only the beginning and ending attribute 
characters are sent to the screen. Thus, the display attribute of a field can be 
reset to normal if the field immediately preceding this field is selected and this 
field is not selected. For example, assume that DSPATR(UL) is in effect for 
two consecutive fields with overlapping attribute characters. If on an output 
operation with PUTRETAIN in effect, the first of these fields is selected and 
the second field is not selected, the display attribute of the second field is 
reset to the norma! display attribute. This is because CPF sends the first field 
to the screen with beginning and ending attribute characters, and its ending 
attribute character overrides the beginning attribute character of the second 
field. 

The following example shows how to specify the PUTRETAIN keyword (for 
additional examples of the PUTRETAIN keyword at the record and field level, 
see the CPF Programmer's Guide): 
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RANGEdow high) 

Use this field level keyword for input-capable fields to specify that CPF is to 
perform validity checking on the data that the work station user keys into the 
field. The data keyed must be greater than or equal to the lower value, and 
less than or equal to the higher value. 

When the field is a character field, the parameter values must be enclosed in 
apostrophes. When the field is numeric, apostrophes must not be specified. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the RANGE keyword: 
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REF{clata-bas@-file»naine[.library-name][r@cord’format-name]) 

Use this file level keyword to specify the name of a file from which field 
descriptions are to be retrieved. Use it when you want to duplicate descriptive 
information from several fields in a previously described record format. You 
can code the file name once here rather than on REFFLD keywords with each 
of the field descriptions that reference the file. To reference more than one 
file, use the REFFLD keyword. (The REF keyword can be specified only once.) 

If there is more than one record format in the referenced file, specify a record 
format name as a parameter value for this keyword to tell CPF which one to 
use unless the record formats should be searched sequentially. 

The file name is a required parameter value for this keyword; the library name 
and the record format name are optional. 

If you do not specify the library name, the current library list is used. If the 
record format name is not specified, each record format Is searched in order 
(as they are specified); the first occurrence of the field name is used. See 
Appendix A, How to Specify REF and REFFLD, for the search sequences 
determined by your choice of REF and REFFLD keywords. 

Option indicators are not valid with this keyword. 
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REFFLD(referenced-fieicl-name[.record-format-name] 


r*sRc 

V data-base-file name[.library-name]J ^ 


Use this field level keyword when referencing a field under one of these three 
conditions: 


• The name of the referenced field is different from the name in positions 19 
through 28. 

• The name of the referenced field is the same as the name in positions 19 
through 28, but the record format, file, or library of the referenced field is 
different from that specified with the REF keyword. 

• The referenced field occurs in the same DDS source file as the referencing 
field. 

The referenced field name is required even if it is the same as the referencing 
field. Use the record format name when the referenced file contains more than 
one record format. Use *SRC to search the DDS source file in which the 
referencing field occurs (this is the default value when the data base file name 
and library name are not specified). Specify the data base file name (qualified 
by its library name if necessary) when you want to search a particular data 
base file. 


If, in the same DDS source file, you specify REF at the file level and REFFLD 
at the field level, the REFFLD specification is used. The particular search 
sequence depends on both the REF and REFFLD keywords. For more 
information, see Appendix A, How to Specify REF and REFFLD. 

An R must be specified in position 29. 

Option indicators are not valid with this keyword. 
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The following example shows how to specify the REFFLD keyword. See the 
example in Appendix A, How to Specify REF and REFFLD, for explanations of 
the various specifications. 
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ROLLUP/ROLLDOWN[(response-indicator Ttext'])] 


Use these file or record level keywords to specify that you want to use your 
program to handle any situation where the work station user has pressed the 
specified key and CPF cannot roll the display. If this situation occurs and you 
have not specified this keyword (whichever keyword is appropriate), CPF issues 
an error message indicating that the key is not valid at that time. 

You can specify a response indicator with this keyword. If you do, and the 
appropriate roll key is pressed, CPF sets on the specified response indicator 
within the input record and returns control to your program after it processes 
the input data. If you do not specify a response indicator and the specified roll 
key is pressed, CPF performs normal input record processing. 

These keys cause data to be returned from the display device to your program 
(similar to CF and Enter/Rec Adv keys). 

If CPF is performing the roll function for subfiles (SFLSIZ value does not equal 
SFLPAG value), you do not need to specify these keywords. For a description 
of what happens when ROLLUP and ROLLDOWN are specified for a subfile, 
see the extended description of the SFLROLVAL keyword. 

For additional information on how to use this function, see the CPF 
Programmer’s Guide. 

The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text Is truncated to 50 characters on the program listing. 

Option indicators are valid with these keywords. 

The following example shows how to specify the ROLLDOWN keyword: 
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Use of Routing Keywords 

You can use the routing keywords (RTG prefix) to cause CPF to place specific 
information regarding input operations (up to 80 characters) in the routing 
identification field in the I/O feedback area. No information is entered for an 
output-only operation. 

CPF places the information in the routing field only after validity checking, data 
alignment, and other specified functions have been performed successfully. 
Option indicators are not valid for routing keywords. Routing keywords are not 
valid for subfile records. For further information see the appropriate high-level 
language manual. 

Note: Other portions of the feedback area contain Information such as device 
type, cursor address, and the actual AID byte (one character) representing the 
attention or function key entered (see the RTG AID keyword). 

Each routing keyword requires that you specify a routing field location, which is 
the first character position for that item in the routing field within the I/O 
feedback area. All entries must fit completely within the 80-byte routing area, 
and no checking Is done to prevent overlapping entries in the routing area. If 
entries do overlap, the results can be predicted, based on the processing order 
of the keywords. Entries processed later overlay entries processed earlier. 

Note: Multiple specifications are not checked for overlap in the I/O feedback 
area. 

The processing order of the routing keywords follows: 

RTGCON 
RTGDEVCLS 
RTGDEV 
RTG AID 
RTGFMT 
RTG FIRST 

RTGPOS (only valid when USRDFN also specified) 

RTGFLD 
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ROUTING Keywords Figure 4-S shows how to specify some of the routirig keywords: 
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Figure 4-8. Routing Keyword Coding Example 
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RTGAID(startmg-routing-field-location) 

Use this record level keyword to cause CPF to indicate the AID (attention 
identifier) byte (the command key definition as received from the display) as a 
2-byte identifier placed into the routing field as follows: 


Key 

Identifier 

CAor CF 01-24 

01-24 

Enter Key 

RA 

Record Advance 

RA 

Roll Up 

UP 

Roll Down 

DN 

Print 

PT 

Clear 

CL 

Help 

HP 

Record Backspace (Home) 

BS 

Light Pen Auto Enter 

LP 


Valid starting locations you can specify are within the range 1 through 79. 
Figure 4-8 shows how to specify the RTGAID keyword. 


RTGCON(starting-routing-field-location 'constant') 

Use this record level keyword to specify that CPF is to place the constant that 
you included as a parameter value with this keyword into the specified 
locations of the routing area. 

Valid locations you can specify are within the range 1 through 80, depending 
on the length of the literal. 

Figure 4-8 shows how to specify the RTGCON keyword. 
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RTGDEV(starting-routing-field-location) 

Use this record level keyword to cause CPF to place the 10-character device 
name into the routing field. Valid locations you can specify are within the 
range of 1 through 71. 

Figure 4-8 shows how to specify the RTGDEV keyword. 


RTGDEVCLS(starting-routing-field-location) 

Use this record level keyword to cause CPF to place the 2-character device 
class indicator into the routing field. Valid locations you can specify are within 
the range of 1 through 79. 

The class values that are placed in the routing field ere as follows: 

01 System console, 16x64 
02 Work station, 12x80 
03 Work station, 24x80 

Figure 4-8 shows how to specify the RTGDEVCLS keyword. 


RTGFIRSTCstarting-routing-field-location entry-length) 

Use this record level keyword to specify that CPF is to take the first field that 
it receives from the display and place it in the routing area at the specified 
location using the number of positions that you specified as the entry-length 
parameter value. If the length of the first field received does not match the 
field length you specified, CPF either pads or truncates to fit; the pad 
characters are hex FO for numeric fields and hex 40 for character fields. If no 
fields are received from the display, the specified part of the routing area is 
cleared to blanks (hex 40). 

The valid locations you can specify are within the range 1 through 80, 
depending on the entry length. 

Note: Only the first field received from the display can satisfy this keyword. In 
addition, the location of the first field (line and position) must match the 
location of a field described in this record. If the location of the first field does 
not match a field of this record, the RTG field is updated as if no fields were 
received from the display. 

Figure 4-8 shows how to specify the RTGFIRST keyword. 
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RTGFLD(starting-routing-field-location) 
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Use this field level keyword (routing field) to specify that the field you are 
defining is to be a routing field and the contents of the field are to be placed 
in the routing area, starting at the location you specified with this keyword. 

You can specify the RTGFLD keyword only once for each field description. It is 
valid only for input-capable fields. The contents of this field are placed in the 
routing-field routing area whether or not the field was selected on the output 
operation, and whether or not the user entered any data into the field. If the 
field contains no data when read, the area is initialized with hexadecimal FOs 
for numeric fields and with hexadecimal 40s for character fields. 

The valid locations you can specify with this keyword are in the range of 1 
through 80, depending on the field length. 

Figure 4-8 shows how to specify the RTGFLD keyword. 


RTGFMT(starting-routing-field-location) 

Use this record level keyword (routing format) to cause CPF to place the record 
format name (as determined by CPF for the input operation) into the routing 
field. The length of this entry in the routing field is always 10 bytes. 

Valid field locations you can specify are within the range of 1 through 71. 

Figure 4-8 shows how to specify the RTGFMT keyword. 
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RtGPOS(starting-routmg-field-location starting-data-position 
ending-data-position) 

Use this record level keyword to identify character positions (within the data 
received from the display) that are to be placed into the routing field; the 
RTGPOS keyword is valid only for user-defined data streams (USRDFN 
keyword). The positions are specified by supplying the starting position 
(relative to the beginning of the data stream) and ending position. 

Valid field locations you can specify are within the range 1 through 80, 
depending on starting and ending data locations. 

Note: The starting data position and the ending data position are not checked 
to ensure that they are within the limits of the user-defined data stream. 

The foiiowing example shows how to specify the RTGPOS keyword: 
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Use this record level keyword to specify that when your program issues an 
input operation to this record format CPF is to return the same data that was 
returned on the previous input operation issued to this record format. The 
RTNDTA keyword is ignored if the record format has not already been read. 
When the RTNDTA keyword Is in effect your program can reread data on the 
display without requiring CPF to actually pass data from the display device to 
your program. 

The RTNDTA keyword is ignored in the following situations: 

• On the input portion of an output/Input operation (Put-Get operation) 

• On an input operation that is preceded by an output operation to the same 
record format 

The RTNDTA keyword has effect only in the following situation: 

• On an input operation following an input operation issued to the same 
record format without an intervening output operation to that record format. 

The following are two uses of the RTNDTA keyword: 

« To allow a main program to read a record format that is modified by a work 
station user. The data read tells the main program which subprogram to 
call. The subprogram Issues an Input operation to the same record format 
with RTNDTA In effect to read the same data. This procedure can 
substitute for passing parameters to subprograms. Note that SHARE(*YES) 
must be specified for both display files. 

® To allow an RPG III program to perform file maintenance with less locking 
of records in the data base. For instance, the program reads a data base 
record and displays the record at the display device. The work station user 
reviews the record, makes any required changes, and presses the Enter/Rec 
Adv key. While the work station user is making changes, the data base 
record, if locked, is unavailable to other programs. Hence it is 
recommended to leave the data base record unlocked. However, when the 
program reads the record from the display and updates the data base 
record, the data base record overlays the internal representation of the 
display record in the program; instead of preventing the overlay by using 
different field names for the display record and the data base record, the 
program rereads the display file. With RTNDTA specified, the program 
retrieves the display record again and can then finish updating the data 
base. 

If the UNLOCK keyword is specified, the RTNDTA keyword cannot be 
specified. 

Option indicators are not valid with this keyword. 
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The following example shows how to specify the RTNDTA keyword 
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I SETOF(response-indicator ['text']) 
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Use this record level keyword to specify that when an input operation issued to 
this record format is completed, the specified response indicator is to be set 
off. 

The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 

This keyword can be used to cause an option indicator that is on for 
an output operation to be returned in the off condition when the next input 
operation to the record is completed. (If no input operation is performed, the 
response indicator remains unchanged.) Your program does not have to turn 
the indicator off. 

Option indicators are not valid with this keyword. 

The SETOF is equivalent to SETOFF. 

Note: Any indicator is valid for this keyword. It does not have to be previously 
defined as an option or a response indicator. The indicator becomes a 
response indicator when you specify SETOF. 

If the Indicator used with the SETOF keyword is also used with another 
keyword, such as CHANGE, the on/off status of the indicator is controlled by 
the other keyword. 
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The following example shows how to specify the SETOF keyword: 


Sequence 

Number 


Condition Name 


19 20 21 22 23 24 25 26 27 28 


pO 31 32 33 34 


45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 i 


$iET0F(fe5 * Qv> “di\ s y 


lOOOiol 


ICUSHSTl 






mom 




MU 


RRnsGip(»is(;a<»^^ coMSoueMS6l^ 


Iqoq^qI 


m 


In this example, first-level text of MSG2000 is displayed on the 
message line when the program issues an output operation to 
CUSMST with indicator 63 set on. On the next input operation to 
CUSMST, the SETOF keyword sets off indicator 63. (Indicator 63 is 
used as both an option and a response indicator.) Specifying SETOF in 
the DOS eliminates the need to set off the indicator in the program 
and can simplify RPG program logic. See the Cobol Reference Manual 
and Programmer's Guide for information on handling indicators in 
COBOL programs. 


SETOFF(response-indicator["text']) 

The SETOFF keyword is equivalent to the SETOF keyword. The SETOF 
keyword is preferred because it is compatible with DOS on other systems. See 
the SETOF keyword description for a description of how to use these keywords. 
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Use this record level keyword to specify that this record format is to be a 
subfile record format. This record format (including its related field 
descriptions) must immediately precede the subfile control record format 
(identified by the SFLCTL keyword). 

At least one displayable field must be specified in the subfile record format 
(unless the subfile is a message subfile; see the SFLMSGRCD keyword). The 
locations specified for fields in this record format are the locations on the 
screen where the first subfile record in any one page of the subfile is 
displayed. The rest of the page of records is displayed below the first record. 
The number of records in a page is determined by the parameter value 
specified for the SFLPAG keyword. For an explanation of how many display 
lines are occupied by a subfile, see the SFLPAG keyword description. 

Displayable fields specified on the subfile control record format can be 
displayed at the same time as subfile records; however, fields specified in the 
subfile control record format cannot overlap fields specified in the subfile 
record format, even if they are specified with option indicators. 

The number of subfiles (each having one SFL and one SFLCTL keyword 
specified) that can be specified in a display file is limited only by the number of 
record formats permitted in a display file (1024 record formats, or 512 subfiles, 
maximum). However, only two subfiles can contain active records or be 
displayed at one time. 

For examples of subfiles, see Appendix F, Examples. 

Option indicators are not valid with the SFL keyword. 

In addition to the SFL keyword, the following keywords are also valid on the 
subfile record format: 

• For message subfiles: 

SFLMSGRCD (required at the record level) 

SFLMSGKEY (required at the field level) 

SFLPGMQ 

• For all other subfiles (at the record level only): 

CHANGE 

CHECK(AB) 

CHECK(RL) 

CHGINPDFT 

INDTXT 

KEEP 

LOGINP 

LOGOUT 

SETOF 

SETOFF 

SFLNXTCHG 

TEXT 
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The following otherwise valid keywords are not valid at the field level when 
specified for the subfile record format: 


DATE 

ERRMSG 

ERRMSGID 

TIME 


The following field level keywords are valid on the subfile record format when 
SFLPAG equals SFLSIZ 


or 


SFLPAG does not equal SFLSIZ and these keywords are not conditioned. 


The keywords are: 

AUTO(RA) 

CHECK(ER) 

CHECK(ME) 

DSPATR(PR) 

DSPATR(MDT) 

DUP 

The following example shows how to specify the SFL keyword: 
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Use this record level keyword on the subfile control record format so that your 
program can clear the subfile of all records. This keyword differs from the 
SFLDLT keyword in that the subfile area is not deleted; it differs from the 
SFLINZ keyword in that after being cleared, the subfile contains no data. 
Clearing the subfile does not affect the display; however, after being cleared, 
the subfile contains no active records. 

When active records already exist in the subfile and all are to be replaced, your 
program can issue an output operation to the subfile control record format 
after selecting the SFLCLR keyword. This clears the subfile and permits your 
program to write new records to the subfile (by issuing output operations to 
the subfile record format while incrementing the relative record number). 

Issuing an output operation to an already active subfile record causes an error 
message to be returned to your program. 

If the SFLCLR keyword is In effect on an output operation and no records exist 
in the subfile, the SFLCLR keyword is ignored. 

An option indicator is required for this keyword to prevent CPF from clearing 
the subfile on every output operation to the subfile control record format. 

This optional keyword is valid only for the subfile control record format. 

Screen size condition names are not valid for this keyword. 

The following example shows how to specify the SFLCLR keyword: 
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SFLCTL(subfile-record-format-name) 

Use this record level keyword (subfile control) to specify that this record format 
is to be a subfile control record format. This record format must immediately 
follow the subfile record format. 

You must specify the name of the subfile record format as the parameter value 
for this keyword. The subfile control record format can contain field 
descriptions as well as subfile control keywords. 

Your program can display subfile records only by issuing an output operation to 
the subfile control record format. 

The subfile record format (SFL keyword) defines the format of the records in 
the subfile as opposed to the subfile control record format (SFLCTL keyword), 
which defines how the subfile can be displayed, cleared, deleted, and 
initialized. The program issues output operations to the subfile record format 
to build the subfile; it issues output operations to the subfile control record 
format, setting option indicators for various subfile keywords, to display, clear, 
delete, and initialize the subfile. (See SFLMSGRCD, SFLMSGKEY, and 
SFLPGMQ keyword descriptions for Information on message subfiles.) 

Option Indicators are not valid with this keyword. 

The following example shows how to specify the SFLCTL keyword: 
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The parameter value on the SFLCTL keyword must be the name of 1 
the subfile record format (identified by the SFL keyword). | 
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A summary of subfile keywords used with the SFLCTL keyword follows. (Field 
level keywords are used with fields in the subfile control record format): 
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Required 

Optional 

SFLCTL 

SFLLIN 

SFLPAG 

SFLEND 

SFLSIZ 

SFLDSPCTL 

SFLDSP 

SFLCLR 


SFLDLT 


SFLDROP 


SFLENTER 


SFLINZ 


SFLRCDNBR 


SFLRNA 


SFLROLVAL 


SFLMSG 


SFLMSGID 


SFLPGMQ 


If subfile size equals subfile page, the following keywords are ignored. When 
several display sizes are used (DSPSIZ keyword specified), these keywords are 
ignored only for screen sizes for which subfile size equals subfile page. 

SFLDROP 

SFLROLVAL 

If the subfile record format contains field selection, the following keywords are 
not valid on the subfile control record format: 

SFLDROP 

SFLINZ 

SFLLIN 

SFLRCDNBR 

SFLRNA (because SFLINZ is not valid) 

SFLROLVAL 

The USRDFN keyword is not valid for the subfile control record format. 
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SFLDLT 


Use this record level keyword with an option indicator on the subfile control 
record format to enable your program to delete the subfile. When two subfiles 
in a display file are already active and a third subfile is to be made active, your 
program must delete one of the active subfiles before making the third active. 
To make a subfile active, your program issues an output operation to the 
subfile record format or issues an output operation to the subfile control record 
format with SFLINZ In effect. To delete a subfile, your program issues an 
output operation to the subfile control record format with SFLDLT in effect. 
(Closing the display file deletes all the active subfiles.) 

If your program issues an output operation with SFLDLT In effect to a subfile 
that is not active, the SFLDLT keyword is ignored. 

Option indicators are required for this keyword; screen size condition names 
are not valid. 

The following example shows how to specify the SFLDLT keyword: 
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Use this record level keyword on the subfile control record format to assign a 
CA or a CF key. The work station user presses this key to fold or to truncate 
subfile records that require more than one display line. 

Without the SFLDROP keyword, CPF displays the entire subfile record and 
folds it where needed. When the SFLDROP keyword is specified, CPF first 
displays the subfile in truncated form; subfile records are truncated to fit on 
one display line. When the work station user presses the specified key, CPF 
redisplays the records in folded form. Each record continues onto subsequent 
lines immediately following the line the record starts on. See example 13 in 
Appendix F, Examples. 

Pressing the specified key changes the form of the displayed subfile from one 
state to the other. 

In the truncated form, more records are displayed than are specified on the 
SFLPAG keyword; in the folded form, as many records are displayed as are 
specified on the SFLPAG keyword. 

CPF truncates subfile records in the middle of output-only fields; however, if 
the truncation is in the middle of an input-capable field, the whole field is 
omitted from the screen. If this results in omitting the entire record from the 
screen, an error message is sent to the display and the record is not truncated. 
Instead, it is displayed in folded form. 

Notes: 

1. A warning message is issued at file creation time if the entire record fits 
on a single screen line. 

2. If subfile size equals subfile page, the SFLDROP keyword is ignored. 
When several display sizes are used (DSPSIZ keyword specified), 
SFLDROP is Ignored only for screen sizes for which the subfile size 
equals subfile page. If the subfile record format contains field selection, 
the SFLDROP keyword is not valid. 

3. If the subfile contains input-capable fields, it is recommended that you 
specify a CF key rather than a CA key. If you specify a CA key in this 
situation, modified data is lost when the key is pressed. 

4. If two subfiles using SFLDROP are displayed at one time, the same 
command key should be specified on both SFLDROP keywords. If they 
are different, only the key specified for the most recently displayed 
subfile is in effect. Pressing the command key affects the subfile 
containing the cursor. If the cursor is not positioned in a subfile, the 
command key affects the upper subfile. 

Option indicators are not valid with this keyword. 
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The following example shows how to specify the SFLPROP keyword: 
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Use this record level keyword on the subfile control record format so that CPF 
displays the subfile when your program issues an output operation to the 
subfile control record format. If you do not use an option indicator with this 
keyword, a page of subfile records is displayed on every output operation to 
the subfile control record format. 

See the SFLRCDNBR keyword description to determine which page of subfile 
records is displayed when the subfile is displayed. 

If your program issues an output operation to the subfile control record format 
when the SFLDSP keyword is in effect and no records exist in the subfile, an 
error message is sent to your program. 

This keyword is required, and is valid only for the subfile control record format. 
Screen size condition names are not valid for this keyword; option indicators 
are valid. 

The following example shows how to specify the SFLDSP keyword: 
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In this example, the subfile is displayed when option indicator 01 is set H 
on for an output operation to SFLCTLR. | 
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SFLDSPCTL 


Use this record level keyword on the subfile control record format so that CPF 
displays fields in the subfile control record format when your program issues 
an output operation to the subfile control record format. If you do not use an 
option indicator with this keyword, the subfile control record is displayed on 
every output operation to the subfile control record format. 

This optional keyword is valid only for the subfile control record format. 

Screen size condition names are not valid for this keyword; option indicators 
are valid. 

Note: SFLDSPCTL must be in effect when the subfile is displayed for an input 
operation to the subfile control record to be valid, even if there are no 
displayable fields in the subfile control record format. 

The following example shows how to specify the SFLDSPCTL keyword: 
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In this example, both the subfile and displayable fields in the subfile 
control record format are displayed when option indicator 01 is set on 
for an output operation to SFLCTLR. 
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SFLEND 

Use this record level keyword on the subfile control record format to permit 
the display of a plus sign (+) in the lower, rightmost display location occupied 
by the subfile. The plus sign indicates that the work station user can roll up 
the subfile to display more records by pressing the Roll Up key. 

An option indicator must be specified with this keyword. 

Rolling by Your Program (SFLPAG Equals SFLSIZ): Your program controls the 
display of the plus sign through the use of the indicators on the SFLEND 
keyword. Set the indicators off to display the plus sign; set the indicators on 
to remove the plus sign from the display. When the Roll Up key is pressed, 
your program handles processing; for instance, it reads the subfile, clears it, 
then rewrites the subfile with new records and redisplays the subfile. If your 
program does this, display the plus sign; if not, remove the plus sign from the 
display. 

Rolling by CPF (SFLPAG Does Not Equal SFLSIZ): CPF displays the plus sign 
as long as there are more records in the subfile to be displayed, no matter how 
the option Indicator is set. When the last page of the subfile is displayed, CPF 
displays the plus sign if the indicator is off and does not display the plus sign 
if the indicator is on. 

Your program must set the indicator on or off when displaying the subfile. 

(Your program cannot find out, when CPF is roiling the subfile, which page of 
the subfile is displayed.) 

If your program sets off the indicator for SFLEND when displaying the subfile, 
the plus sign is displayed with the last page of the subfile. Because the plus 
sign is displayed but CPF cannot roll the subfile any further, your program 
must provide for any further rolling. Specify the ROLLUP keyword on the 
subfile control record format so that control is passed to your program when 
the Roll Up key is pressed again. When your program receives control, it must 
clear the subfile, refill it with new subfile records, and redisplay the first page 
of subfile records. 

Position of Plus Sign: For the 5250 work station, positions 78 through 80 of 
the last line occupied by the subfile are used for the plus sign (beginning 
attribute character, plus sign, and ending attribute character). For the system 
console, positions 63 through 64 of the last line occupied by the subfile are 
used for the plus sign (screen attribute, plus sign). 

Note: For both the 5250 work station and the system console. If an Input field 
occupies the location of the plus sign and the field is modified, the plus sign 
and its attribute characters are returned to the program as data in the field. 


Display Files 
SFLEND 


Display Files 4-169 



Display Files 
SFLEND I 


The following example shows how to specify the SFLEND keyword: 


p 



Cundftioning 

QC 

a 

1. 
17 1 

Name 

B 19 20 21 22 23 24 25 26 27 28 

0 $ Reference (R) 

Length 

30 31 32 33 34 

a Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

i| 

II 

36 37 

Usage (b/O/l/B/H/M) 

Location 

Functions 

45 46 47 48 49 so SI S2 53 S4 55 S6 57 58 69 60 61 62 63 64 6666 67 686970 71 7273 74 7576 77 7879 

Sequence 

Number 

1 2 3 4 S 

* Form Type 

1 

1 

7 

Z 

1 

I 

Condition Name 

iO 

^ Indicator 

i 

o 

z 

11 

1 

1 

12 13 

Z 

1 

14 

1 

J 

IS 16 

Line 

39 4041 

Pbt 

42 43 44 

0 

oio 

jjo 

A 





_J 






R. 

SPUR 












50 

lM M M M M i M M M M 
















A 









































A 












<Af* 1 e 


¥ 


0 

ifie A* 

% 


i 





M I I M M 1 M ii M 
















A 



































pp 

o 


A 










E- 











SiFl.C.TL^SFLft.1 













A 

































oio 


A 





















SiFt51zCi75 












bppirlo 

A 



01 


















SPL.0SP 












do 

omo 

A 


N 


















y 

M M M M M M M 














A 





















i M 1 1 i i i i : i i i : i 














A 









1. 

J. 


1.^ 







.. 















In this example, the subfile and the plus sign are displayed when 
option indicator 01 is set on for an output operation to SFLCTLR. 
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Use this record level keyword on the subfile control record format to specify 
that the Enter/Rec Adv key is to be used as a Roll Up key. This allows CPF to 
roll up a subfile of more than one page when the Enter/Rec Adv key is 
pressed. The parameter value with this keyword is required; use it to specify a 
command key to replace the Enter/Rec Adv key while this function is active. 
This keyword is normally used when the subfile is entirely entered by the work 
station user or when the user changes some records in the subfile and adds 
others. 

If a subfile is not currently displayed and the Enter/Rec Adv key is pressed, 
control is returned to your program. 

This optional keyword is valid only for the subfile control record format. Option 
indicators are not valid for this keyword. 

Note: This keyword is In effect only until the next output operation. At the 
next output operation, the specifications for that record apply. 

If two subfiles with SFLENTER in effect are displayed, only the last SFLENTER 
keyword to be displayed is in effect. The cursor position at the time the key is 
pressed determines which subfile is affected. 

The following example shows how to specify the SFLENTER keyword: 
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In this example, the Enter/Rec Adv key is 
enter data, the work station user presses C 
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SFLINZ 

Use this record level keyword on the subfile control record format to specify 
that CPF is to initialize all records in the subfile on an output operation to the 
subfile control record format (identified by the SFLCTL keyword). The fields in 
each subfile record are initialized to blanks for character type fields, to zeros 
for numeric type fields, or to the constant value specified on input-only fields 
for which the DFT keyword is specified. 

When the subfile is displayed (on an output operation to the subfile control 
record), all records in the subfile are displayed with the same value. Any 
record previously written is overwritten and no longer has its earlier value. 

The following is true when SFLINZ is in effect on an output operation to the 
subfile control record format. If keywords (suc-h as DSPATR(H!)) are specified 
on fields in the subfile record format, and if option indicators are specified on 
those keywords, the subfile is displayed as if ail option indicators are off (hex 
FO). Note that a keyword can be selected if N is specified for the option 
indicator. 

After your program issues an output operation to the subfile control record 
with SFLINZ in effect, all records in the subfile are considered active but not 
modified. They are considered modified only when the work station user 
modifies them or when your program issues an output operation to the subfile 
record format with SFLNXTCHG in effect. 

To initialize a subfile with no active records, see the SFLRNA keyword. 

In general, use the SFLINZ keyword for the following purposes: 

• Specify SFLINZ with UNLOCK(*ERASE *MDTOFF) when your program is to 
build a transaction file. Do not specify validity checking keywords for fields 
in the subfile record format. This is a fast data-entry approach that is 
discussed in the Application Example /. 

• Specify SFLINZ with SFLRNA so that the work station user can add records 
to a subfile that your program has already partially filled with records before 
displaying it. 

• Specify SFLINZ with SFLPGMQ so that your program can build a message 
subfile with a single output operation. (See the SFLPGMQ keyword 
description later in this chapter.) 

Notes: 

1. If field selection is used in the subfile record format, the SFLINZ keyword is 
not valid. Your program can only initialize the subfile by a series of output 
operations to the subfile record format, selecting fields as needed. 

2. The SFLINZ keyword cannot be specified on the subfile control record 
format for a message subfile (see the SFLMSGRCD keyword) unless the 
SFLPGMQ keyword is also specified at the field level in the same subfile 
control record format. 


4-172 





Option indicators are valid with this keyword; screen size condition names are 
not valid. 

For an example of SFLINZ and SFLPGMQ, see example 19 in Appendix F. 
Examples. 

For an example of SFLINZ and SFLRNA, see example 12 in Appendix F. 
Examples. 

The following example shows how to specify the SFLINZ keyword: 
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For more information on initializing subfiles, see the CPF Programmer's Guide. 
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SFLLIN(spaces) 

Use this record level keyword on the subfile control record format to specify 
that the subfile is to be displayed as a horizontal subfile (having more than one 
column of records displayed). The parameter value specifies the number of 
spaces (including attribute characters) between columns of records. 

For example, specifying the SFLLIN keyword causes a subfile of four records 
to be displayed as: 

REC1 REC3 The parameter value for SFLLIN 

REC2 REC4 specifies the number of spaces 

appearing between columns. 

If SFLLIN is not specified, these records appear as: 

RECl 

REC2 

REC3 

REC4 

If the subfile record format contains field selection, this keyword is invalid. 

if the SFLLIN keyword is to be used for more than one screen size, a screen 
size condition name for each secondary screen size is required. 

Because the SFLPAG keyword specifies the number of subfile records that can 
be displayed at a single time, you must consider the SFLLIN keyword when 
specifying the SFLPAG value. 

The SFLLIN keyword is not valid for a message subfile. 

Option indicators are not valid with this keyword. 
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The following example shows how to specify the SFLLIN keyword: 
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In this example, columns of subfile records appear five spaces apart. 
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SFLMSG('message-text' [response-indicator]) 

SFLMSGID(message-identifier message-file[.library-name]) 

Use these record level keywords on the subfile control record format to identify 
a message to be displayed on the message line when your program does an 
output operation to the subfile control record format. Your program has the 
responsibility to reverse the images of any fields and to position the cursor 
appropriately in the subfile being displayed. As with ERRMSG and ERRMSGID, 
the cursor blinks and the keyboard is locked on the 5250 work station until the 
Reset key is pressed. (These conditions cannot be selected for the system 
console.) 

SFLMSG keyword: Specify the SFLMSG keyword like the ERRMSG keyword. 
The parameters specify a message text and, optionally, a response indicator. 
The message text is the message to be displeyed. (The Heip key is not 
supported, and if pressed, it causes an error message to be sent to the 
display.) 

If you specify a response indicator, it should be the same as the option 
indicator used to condition the SFLMSG keyword. On the input operation that 
follows the display of the error message, CPF turns off the indicator. If the 
response and option Indicators are the same, they are both turned off. One 
exception to this rule is if the response indicator is also specified for another 
keyword such as CHANGE, CAnn, or CFnn. In that case, the on/off setting of 
the response indicator is based on the results of the function provided by the 
CHANGE or CFnn keyword. 

When a response Indicator is specified, the first 50 characters of the message 
text are also used as indicator text. Separate response indicator text is not 
valid for the SFLMSG keyword. 

SFLMSGID keyword: Specify the SFLMSGID keyword as you would the 
ERRMSGID keyword. The parameters specify a message identifier and a 
message file. The message to be displayed is retrieved from the message file 
during program execution. (The Help key is supported for this keyword and 
causes a predefined second-level message from the message file to be 
displayed if it exists.) The library name on the message file is optional. 

Note: The message file used In SFLMSGID must exist in the specified library, 
and the user must have operational rights to the message at program execution 
time. 

Option indicators are valid with these keywords. 
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The following example shows how to specify the SFLMSG and SFLMSGID 
keywords: 
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Whether to Specify Error Message Keywords (ERRMSG and ERRMSGID) or 
Subfile Message Keywords (SFLMSG and SFLMSGID): 

• For fields in the subfile control record format 

• For fields in any nonsubfile record format 

CPF reverses the image of the field or fields in error and positions the cursor 
at the first such field. 

Specify SFLMSG and SFLMSGID: 

• At the record level in the subfile control record format for fields in the 
subfile record format 

Your program must reverse the image of the field or fields in error (by 
selecting DSPATR(Rl)) and position the cursor at the field to be corrected first 
(by selecting DSPATR(PC)). 
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Conditions Occurring During Message Dispiay: The display of messages using 
SFLMSG and SFLMSGID is similar to the display of messages by CPF when 
field validation errors are detected. An important difference from ERRMSG and 
ERRMSGID is that the program, and not CPF, must position the cursor to the 
appropriate field within the subfile, reverse the image of that field within the 
subfile, and also optionally reverse the image of more than one field at a time. 
On the 5250 work station, blinking cursor and message highlighting are 
allowed. On the system console, these display attributes are not allowed. 

Restoration of Reversed image Fieids: See Restoration of Reversed image Fieids 
In the ERRMSG/ERRMSGID keyword description in this chapter. 

Note: The SFLDSP keyword must be in effect for SFLMSG and SFLMSGID to 
be processed. 

Priority Among Seiected Keywords: You can specify either SFLMSG or 
SFLMSGID several times for a single subfile control record format. During 
program execution, set option indicators to select a particular message to be 
displayed and to select particular fields to be displayed in reverse image. 
Several fields can be displayed In reverse image In different records of a 
subfile when the subfile is redisplayed; however, only one message can be 
displayed at one time. 


If more than one error message Is selected at a time, CPF displays the first of 
the following: 


1. ERRMSG (If more than one ERRMSG keyword is 
selected, the first one seiected is displayed.) 

2. ERRMSGID (If more than one ERRMSGID 
keyword is selected, the first one selected is 
displayed.) 


Effective for individual 
fields within the subfile 
control record format 


3. SFLMSG (If more than one SFLMSG keyword is 
seiected, the first one seiected is displayed.) 

4. SFLMSGID (If more than one SFLMSGID keyword 
is selected, the first one selected is displayed.) 


Effective for program- 
selected fields in the 
displayed subfile 
(subfile record format) 


5. Message fieids (M in position 38) (if more than 
one message field is selected, the first one 
seiected is displayed.) 


Effective when specified 
in the subfile control 
record format 


4-178 



SFLMSGKEY 


Display Files 
SFLMSGKEY 


Use this field level keyword on the first field in the subfile record format for a 
message subfile (SFL and SFLMSGRCD specified). It is not valid on the subfile 
control record format (SFLCTL). To select messages from a program message 
queue for display, your program places a message reference key in this field. 
(Your program also places the name of the program message queue in the 
second field in the subfile record format; see the SFLPGMQ keyword 
description). 

This field is predefined as a four-position, character data type, hidden field. 

The following rules apply: 

• This field must always be the first field defined in the subfile record format. 

• The field name and the SFLMSGKEY keyword are the only DDS you can 
specify for this field. 

Option indicators are not valid with this keyword or with the associated field. 

For more information on building and displaying message subfiles, see the 
SFLPGMQ keyword description in this chapter. 

The following example shows how to specify the SFLMSGKEY keyword: 


iJHI 




c 

1 

29 

Length 

30 31 32 33 34 

i 

)< 

% 

GD 

5 

s 

1 

1 

35 

i| 

II 

36 37 

j 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Saquenot 

Number 

1 2 3 4 5 

! 

6 

5 

1 

1 

\ z 

\i 


1 

1 

e 10 

z 

1 

11 

1 

1 

12 13 

Z 

1 

14 

16 

5 

5 

1 

16 


Pos 

42 43 44 

BBEgE 

□1 























s 

0 




Ql 


1 

1 

1 






■ 

IFLDKEY 












1 

1 

■ 



fTPSff. 

□1 










■ 



: 







; ’ 


1 

1 

■ 




Dl 


1 

1 

■ 







IS3SE1! 










SiFLCTLCltCDMS 


H 



EEEI^ 

Dl 


31 

1 

■ 

■ 

■ 



■ 

!■■■ 












■ 

1 

1 




□1 








1 

■ 

IWUHi 


: 










1 

1 

1 




□1 










1 

|[3 



; 











1 

1 

1 




□1 









“1 

■ 

II 












1 








□1 










■ 

II 



' 

















2 

T 








J 

I 

r 




















Display Files 


4-179 




































Display Files 
SFLMSGRCD 


SFLMSGRCD(iine-number) 

Use this record level keyword on the subfile record format to specify that this 
subfile is to be a message subfile and that the records displayed when the 
subfile is displayed are to be messages from a program message queue. 

The parameter value specified with the SFLMSGRCD keyword specifies the 
first line on the display on which messages are displayed. The value specified 
must not be greater than the maximum line number for the screen size being 
used. The number of messages displayed depends on the SFLPAG value 
specified for the subfile. 

For more information on building and displaying message subfiles, see the 
SFLPGMQ keyword description In this chapter. 

Option indicators are not valid with this keyword; however, screen size 
condition names are valid with this keyword. 

The TEXT keyword is valid at the record level for SFLMSGRCD and at the field 
level for the SFLMSGKEY and SFLPGMQ fields. 

The following example shows how to specify the SFLMSGRCD keyword: 
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In this example, the shaded keywords are required on the subfile 
record format for a message subfile. SFLMSGKEY and SFLPGMQ 
must be specified in the order shown. 
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There can be only two predefined fields specified on the subfile record format 
for a message subfile as follows: 

• Message identifier: A four-position, character data type, hidden field. Your 
program uses this field to pass a message identifier to CPF. This field must 
always be the first field defined in the message subfile. You must specify 
the SFLMSGKEY keyword with this field. 

• Program queue name: A 10-position, character data type, hidden field. Your 
program passes the name of the program message queue that contains the 
message(s) in this field. It must be the second field of a subfile message 
record and must immediately follow the first field. If specified also on the 
subfile control record, it can be anywhere within the record specification. 

You must specify SFLPGMQ with this field. (See the SFLPGMQ keyword 
for more details.) 

Screen size condition names can be specified for the SFLMSGRCD keyword 
and are required if the line number for the first message displayed is to 
change, based on display size. 

Data is not returned in your input buffer if your program does an input 
operation for a message subfile. 

The messages are displayed as follows: 

• Each message is displayed on a separate line and is truncated if it is longer 
than the display line length. 

• Each message starts in position 2. The maximum message length for the 
5250 work station is 76 characters; the maximum for the system console is 
61 characters. 

• On the 5250 work station, each message is displayed with the high intensity 
(HI) field attribute. 

When a message subfile is roiled by CPF, the cursor is positioned at the same 
location as it was when the Roil key was pressed. 

Second-level text is supported for these messages. The work station user 
chooses which second-level text is to be displayed by placing the cursor on 
the line containing the first-level message and pressing the Help key. 

Note: When the SFLMSGRCD keyword is specified, the SFLINZ keyword 
cannot be specified without the SFLPGMQ specification. 
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SFLNXTCHG 


Use this record level keyword on the subfile record format to force the work 
station user to correct program-detected keying errors in subfile records that 
have been read by the program. It does this by causing a record to be 
modified so that a Get-Next-Changed operation must read the record as 
described in the following section. 

Subfile Operations With SFLNXTCHG: A typical use of SFLNXTCHG could be as 
follows. A work station user changes (modifies) some records in a displayed 
subfile (this could be for a data-entry application or a data-update application). 
After changing some records, the work station user presses the Enter/Rec Adv 
key, and the program reads only the changed records (with Get-Next-Changed 
operations). If the program detects keying errors in the changed records, it can 
issue update operations (UPDAT in RPG; REWRITE in COBOL) to the subfile 
records in error, setting indicators if necessary so that SFLNXTCHG will be In 
effect during the update operations. These update operations are issued to the 
subfile record format. After the records in error have been updated, the 
program issues an output operation to the subfile control record format to 
redisplay the subfile. (To display an error message, display fields in reverse 
image, and position the cursor, see the keyword description for the SFLMSG 
and SFLMSGID keywords.) With the subfile redisplayed, the work station user 
rekeys data and presses the Enter/Rec Adv key again. If the data Is correct, 
the program does not redisplay the subfile. 

The records in error are returned to the program on a Get-Next-Changed 
operation. This is because the SFLNXTCHG keyword caused the subfile 
records to be considered modified even though the work station user did not 
change them. This allows the program to prohibit the work station user from 
ignoring prog ram-detected keying errors in subfile records. 

Subfile Operations Without SFLNXTCHG: If SFLNXTCHG is not specified, or is 
specified but not selected on the update operations to the subfile records, then 
the work station user can simply press the Enter/Rec Adv key Instead of correcting 
the program-detected errors. The program then reads no records because the 
Get-Next-Changed operations find no modified records the second time the 
Enter/Rec Adv key is pressed. 

Option indicators are valid with this keyword. 

The SFLNXTCHG keyword cannot be specified with the SFLMSGRCD 
keyword. 
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SFLPAG(number-of-records-to-be-dispiayed) 

Use this record level keyword on the subfile control record format to specify 
the number of records in the subfile to be displayed at the same time. (For an 
exception to this rule, see Field Selection later in this keyword description.) 

This keyword is required for the subfile control record format. 

The SFLPAG parameter value and the number of lines required by each subfile 
record determine the number of actual display lines required to display the 
page of records. Not all records within a subfile must be displayed at the 
same time, and not all lines of the display are required to display a page of 
subfile records. 

Option indicators are not valid for this keyword; screen size condition names 
are valid. Screen size condition names are required if you want the number of 
records that can be displayed at one time to change, based on the size of the 
display screen. 


Subfile Page Equals Subfile Size 

When you specify the same parameter values for the SFLPAG keyword and the 
SFLSIZ keyword, the maximum number of records that can be contained in the 
subfile equals the maximum number of subfile records that can appear on the 
display at one time. For this condition, CPF does not automatically roll the 
subfile when the Roll Up or the Roll Down key is pressed. If the ROLLUP and 
ROLLDOWN keywords are specified and one of the Roll keys is pressed, CPF 
returns control to your program instead. If ROLLUP and ROLLDOWN are not 
specified, a message is sent to the work station user, indicating that an invalid 
key has been pressed. 

If subfile size equals subfile page, the following keywords are ignored. When 
several display sizes are used (DSPSIZ keyword specified), these keywords are 
ignored only for screen sizes for which subfile size equals subfile page. 

SFLDROP 

SFLROLVAL 
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Field Selection: When subfile page equals subfile size, you can specify option 
indicators for fields in the subfile record format. This is called field selection. 
When field selection is used in the subfile record, SFLPAG(value) specifies the 
number of display lines available to display the records of this subfile. (Without 
field selection, SFLPAG(value) specifies the number of subfile records that can 
be displayed at one time.) This specification must be considered when a 
subfile record occupies more than one display line. The value of SFLPAG must 
be greater than or equal to the number of display lines occupied by the subfile. 

If the subfile record format contains field selection, the following keywords are 
not valid on the subfile control record format: 

SFLDROP 

SFLINZ 

SFLLIN 

SFLRCDNBR 

SFLRNA (because SFLINZ is not valid) 

SFLROLVAL 

Option indicators for the following field level keywords associated with the 
subfile record format are valid only if the subfile size equals a subfile page: 

AUTO(RA) 

CHECK(ER) 

CHECK(ME) 

DSPATR(MDT) 

DSPATR(PR) 

DUP 


Subfile Page Does Not Equal Subfile Size 

When you specify different parameter values for the SFLPAG keyword and the 
SFLSIZ keyword, CPF recognizes the Roll Up and Roll Down keys and 
automatically rolls the subfile according to the value specified in the field for 
which the SFLROLVAL keyword is specified. If you do not specify the 
SFLROLVAL keyword, CPF rolls the subfile by the parameter value specified 
for the SFLPAG keyword. 
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Use this field level keyword on the second (and last) field in the subfile record 
format for a message subfile. This field contains the name of the program 
message queue used by CPF to build a message subfile. In addition, the 
SFLPGMQ keyword can be specified on the subfile control record format when 
the SFLINZ keyword is specified on the subfile control record format. 

This field is predefined as a 10-position, character data type, hidden field. The 
following rules apply: 

• The field name and the SFLPGMQ keyword are the only DOS you can 
specify for this field. 

• If the name of the program message queue name placed In this field at 
execution time is less than 10 positions, it must be left-adjusted and 
padded with blanks. 

This field is required on the subfile record format (Identified by the SFL 
keyword) to build the subfile one message at a time through multiple output 
operations to the subfile record format. You can also specify this field on the 
subfile control record format (identified by the SFLCTL keyword) to build the 
subfile all at once through a single output operation to the subfile control 
record. Specify option indicators with the SFLINZ keyword to control the way 
the subfile is built. 


Multiple Output Operation: If you specify this field and keyword on the subfile 
record, you build the subfile one message at a time with separate output 
operations to the subfile record format. For each output operation, the 
message identifier must be in the first field of the record (SFLMSGKEY 
keyword), and the name of the program message queue must be in the second 
field. At the time of the output operation, CPF retrieves the identified message 
from the queue and places it in the subfile as a record. 


Single Output Operation: If you specify the SFLPGMQ keyword (with its named 
field) and the SFLINZ keyword on the subfile control record format, you build 
the entire subfile with one output operation directed to the subfile control 
record format. On the output operation, CPF Initializes the subfile with all 
messages that are on the program message queue whose name Is in the 
SFLPGMQ field. If necessary, CPF extends the subfile to contain ail messages 
on the queue. For this function, the SFLMSGRCD, SFLMSGKEY, and 
SFLPGMQ keywords must be specified with the subfile record format (SFL 
keyword). The SFLPGMQ and SFLMSGKEY keywords are ignored for this 
function and your program need not set the values of their fields. 


Display Files 


4-187 



Display Files 

sflpgmq! 


Special Value: The SFLPGMQ field can contain a special value, * (asterisk), 
instead of a program message queue name. If the program moves an asterisk 
to the SFLPGMQ field, CPF uses the message queue of the program issuing 
the output operation. 


Both Multiple and Single Output Operations: If you specify the SFLPGMQ 
keyword with both the subfile record format and subfile control record format, 
you can use the single operation function one time and the multiple operation 
function some other time. Do this by setting indicators before issuing the 
output operation; however, all operations to a particular subfile must be 
consistent (multiple or single, but not intermixed) when preparing for a single 
display of the subfile. 

Option indicators and screen size condition names are not valid for this 
keyword. 

Note: An update operation to the message subfile is valid regardless of how 
the subfile is built 

The following example shows how to specify the SFLPGMQ keyword: 
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In this example, the program can build the subfile with more 
than one output operation (Indicator 01 off) or a single output 
operation (Indicator 01 on) to the subfile control record format. 
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Use this field level keyword on the subfile control record format to specify that 
the first page of the subfile to be displayed is to be the page containing the 
record whose relative record number is in this field. If you do not specify this 
keyword, CPF displays the first page of the subfile by default. 

If CURSOR is specified, the cursor is placed in the subfile record whose 
relative record number is identified by the contents of this field. The cursor is 
positioned at the first input-capable field in the subfile record; if there is no 
input-capable field, the cursor is positioned at the first output-only or constant 
field. For example, if a page can contain three records, and nine records are 
contained in the subfile, a SFLRCDNBR field value of 8 causes records 7, 8, 
and 9 to be displayed. If CURSOR is specified, the cursor appears in record 8. 

This field must be a ^oned decimal field with zero decimal positions. It must 
have the keyboard shift attribute of signed numeric (S in position 35), and it 
can be up to 4 digits in length. It must be defined as an output-only, an 
output/input, or a hidden field. If a value less than 1 or a value greater than 
the number of records in the subfile is contained in this field on an output 
operation to the subfile control record format, an error is returned to your 
program. 

This optional keyword is valid only for the subfile control record format. 

Option indicators are not valid for this keyword. 

You cannot specify both SFLRCDNBR and SFLROLVAL for the same field. 

If the subfile record format contains field selection, this keyword is invalid. 
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The following example shows how to specify the SFLRCDNBR keyword: 
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In this example, either the program or the work station user 
can set the value of the field before displaying the subfile. 
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Use this record level keyword (subfile records not active) with the SFLINZ 
keyword on the subfile control record format so that your program can initialize 
a subfile with no active records. To do this, your program issues an output 
operation to the subfile control record format with the SFLINZ keyword 
selected. The subfile itself becomes active; the subfile records are not 
considered active unless one of the following occurs: 

• Your program issues an output operation to the subfile record format 
placing data in one of the subfile records. The subfile record becomes 
active but is not considered modified unless the SFLNXTCHG keyword is 
also in effect. 

• After your program displays the subfile, the work station user keys data into 
subfile records. The records keyed into become active and modified. 

The SFLRNA keyword is normally used so that a program can write some 
records to the subfile before displaying it and the work station user can then 
add records to the subfile. 

When your program displays a subfile initialized with the SFLINZ and SFLRNA 
keywords in effect, fields in inactive records have the following values: 

• Character fields are blank. 

• Numeric fields are zero-filled. 

• An input-only field with a constant value specified has the constant value. 

Your program cannot issue an input operation to an inactive subfile record. 
Issuing a Get-Next-Changed operation to one of the subfile records returns 
the record only when the record has become active and been modified. 

Your program cannot issue output operations to active records (SFLRNA not 
specified); it must issue update operations. Also, your program cannot issue 
update operations to inactive records (SFLRNA specified); it must issue output 
operations. 

Notes: 

1. The SFLINZ keyword is required when the SFLRNA keyword is specified. 

2. The SFLRNA keyword cannot be specified for a message subfile (identified 
by the SFLMSGRCD keyword on the subfile record format). 

3. If the subfile record format contains field selection, the SFLRNA keyword is 
not valid. 

Option indicators are not valid with this keyword. 
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The following example shows how to specify the SFLRNA keyword: 
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Use this field level keyword in the subfile control record format to specify that 
the work station user can key a value into this field to tell CPF how many 
records to roll up or down when the appropriate Roll key is pressed. 

This field must have the keyboard shift attribute of signed numeric with zero 
decimal positions. It can be up to 4 digits in length, and it must be defined as 
an output/input or input-only field. 

You cannot specify both the SFLROLVAL and the SFLRCDNBR keywords for 
the same field. 

The work station user can roll the data being displayed up or down by first 
keying in the number of records to roll by, then pressing the Roll Up or the 
Roll Down key. (On subsequent rolls, the SFLROLVAL value stays the same 
unless a new number is keyed in before rolling.) If a negative number or zero 
is keyed into this field and a Roll key is pressed, an error message is displayed 
at the work station. 

This keyword is valid only for the subfile control record format; you must 
specify it if CPF is to support the roll-by-record function. 

If this keyword is not specified, CPF rolls the display by the SFLPAG value. 

If subfile size equals subfile page, the SFLROLVAL keyword is ignored. When 
several display sizes are used (DSPSIZ keyword specified), SFLROLVAL is 
ignored only for screen sizes for which subfile size equals subfile page. If the 
subfile record format contains field selection, the SFLROLVAL keyword is not 
valid. 

This field is returned to your program as part of the input for this subfile 
control record. 

Option indicators are not valid with this keyword. 
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If pressing the Roll Down key rolls beyond the first page of records of the 
subfile, two conditions can occur. First, if the first page of records is not 
currently displayed, rolling down will display it. Second, If the first page of 
records is currently displayed, rolling down will cause a message to be 
displayed. (See below for what happens if ROLLDOWN is specified.) 

If pressing the Roll Up key rolls beyond the last active record of the subfile, 
two conditions can occur. First, if the last full page of records is not already 
displayed, keying Roll Up will display it. Second, if the last full page of records 
is already displayed, keying Roll Up will cause a message to be displayed. One 
exception to this rule is that when the SFLROLVAL value is less than the SFLPAG 
value, CPF rolls the subfile again and no message is displayed. 

Certain keywords are helpful when specified with SFLROLVAL: 

• The SFLEND keyword notifies the work station user when the last subfile 
record is displayed. For more information on the SFLEND keyword, see that 
keyword description in this chapter. 

• The ROLLUP or ROLLDOWN keywords cause control to return to the 
program when pressing a Roll Up or a Roll Down key would roll beyond the 
end of the subfile. Without ROLLUP or ROLLDOWN, a message is 
displayed (as described previously). 

The following examples illustrate the use of the SFLROLVAL keyword: 

• Rolling Down: 

Assume that the value specified for SFLPAG is 3, and there are 11 active 
records in the subfile. If records 8 through 10 are currently being displayed, 
and the user enters a roll value greater than 7, pressing the Roll Down key 
displays records 1 through 3. 

If records 1 through 3 are currently displayed, and a Roll Down key is 
entered with a SFLROLVAL value greater than 0, either a message is sent to 
the work station user (ROLLDOWN not specified) or control Is returned to 
the user program (ROLLDOWN specified; the program has responsiblity for 
roiling down). 

• Rolling Up : 

Assume that the value specified for SFLPAG is 3, and there are 11 active 
records in the subfile. If records 8 through 10 are currently being displayed, 
and the user enters a 3 into the SFLROLVAL field, pressing the Roll Up key 
displays record 11 in the uppermost page area of the display. Any lines not 
occupied by that record are blank. If the Roll Up key Is pressed again, the 
last full page of subfile records (records 9 through 11) are displayed. Finally, 
if the Roll Up key is pressed a third time, either a message is sent to the 
work station user (ROLLUP not specified) or control is returned to the user 
program (ROLLUP specified; the program has responsibility for rolling up). 
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This chart lists the conditions that occur when rolling beyond the ends of the 
subfile (when the SFLROLVAL value is greater than SFLPAG value): 


On pressing the Roll Up key: 

If the last full page of records is not already displayed, 
then it is displayed. 

If the last full page of records is already displayed, 
then a message is displayed. 

On pressing the Roll Up key a second time: 

if ROLLUP is specified, control returns to your program. 

If ROLLUP is not specified, a message is displayed. 

On pressing the Roll Down key: 

if the first page of the subfile is not already displayed, 
then it is displayed. 

If the first page of the subfile is already displayed, 
then: 

If ROLLDOWN is specified, control returns to your 
program. 

If ROLLDOWN is not specified, a message is 
displayed. 


Note: See the CPF Programmer's Guide for an explanation of how the position 
of the cursor at the time the Roll key is pressed affects rolling. 
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SFLSIZ(number-of-records-m-subfile) 

Use this record level keyword on the subfile control record format to specify 
the number of records in the subfile. The maximum number of records allowed 
is 9999. 

This keyword is required for the subfile control record format. 

Option indicators are not valid with this keyword. Screen size condition names 
are valid and are required if the number of records within the subfile changes 
depending on the screen size. 
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Subfile Size Equals Subfile Page: When you specify the same parameter values 
for the SFLSIZ keyword and the SFLPAG keyword, you can specify option 
indicators for fields in the subfile record format. (This is called field selection.) 
When the subfile is built, the records can vary in length depending on which 
fields are selected, and each output operation places records into successive 
positions within the subfile. When the subfile is displayed, each record can 
require a different number of display lines. The number of records that actually 
fit in the subfile depends on the fields selected for each record written to the 
subfile. If the last subfile record written to the subfile fits exactly into the 
subfile, a status message (CPF 5003) is returned to your program. If the last 
subfile record written to the subfile overflows the subfile, a notify message 
(CPF 5043) is returned to your program. 

The specified SFLPAG value is incremented to equal the maximum number of 
records that fit on the display when all the following conditions are true: 

• The value of SFLSIZ equals the value of SFLPAG. 

• Field selection is not used. 

• SFLPAG and SFLLIN are specified such that the number of subfile records 
to be displayed cannot occupy a full screen. 

To maintain SFLSIZ(value) equal to SFLPAG(value), the SFLSIZ value is 
incremented to equal the SLFPAG value. 

For example. If SFLPAG(13) and SFLSIZ(13) are specified, and the subfile 
record format and SFLLIN value are specified such that three records can fit on 
a single display line, SFLPAG and SFLSIZ are incremented to 15. 
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Consider the following example. You specify the DDS for a subfile like this: 
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Your program issues the following output operations: 


Output 

Option Indicators 


Operation to 

Set 

Result 

SFLR 

21 on 

22 off 

Only FIELD1 written to subfile 

SFLR 

21 on 

22 on 

FIELD1 and FIELD2 written to subfile 

SFLR 

21 off 

22 on 

Only FIELD2 written to subfile 

(CPF issues status message CPF 5003 to your program.) 

SFLCTLR 

no indicator 

necessary 

Subfile displayed 
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The resulting display looks like this: 
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SFLPAG(5) 


XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXkXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX- 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx- 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-- 


xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx- 


First record: 

— FIELDl 
Second record: 
'^FIELDI 

— FIELD2 
Third record: 

■FIELD2 


A fourth record cannot be written to the subfile because there is not room on 
the display for it (SFLPAG(5) has been specified in the DDS). 


Subfile Size Does Not Equal Subfile Page: When you specify different parameter 
values for the SFLPAG keyword and the SFLSIZ keyword, the SFLSIZ value 
specifies the number of records that can be placed into the subfile. If your 
program places a record with a relative record number larger than the SFLSIZ 
value into the subfile, the subfile is automatically extended to contain It (up to 
a maximum of 9999 records). 
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SLNO(n I *VAR) 

Use this record level keyword (starting line number) to specify a starting line 
number for the record format you are defining. The SLNO keyword, if 
specified, adjusts the actual line numbers for each field in the record format. If 
you do not specify SLNO, fields in the record format are displayed on the lines 
you specify for them in positions 39 through 41. You can specify one of two 
parameter values for this keyword: 

• Specify n, where n is a value between 1 and 24. All fields in the record 
format are offset n - 1 lines down the screen from their specified locations. 

• Specify *VAR to enable your program to set the starting line number at 
execution time before displaying the record format. At file creation time, 

CPF sets the starting line number to one. If your program does not set the 
starting line number or sets it to zero, CPF assumes its value is one. If your 
program sets the starting line number to a value such that the first field in 
the record format does not all fit on the screen, or sets it to a negative 
value, CPF issues a notify message (CPF 5002) to your program, and the 
record is not displayed. 

To calculate the line on which a field is actually displayed, subtract one from 
the line number specified in positions 39 through 41 and add the starting 
line number to the result. 

If the CLRL(nn) keyword is also in effect for this record when it is to be 
displayed, lines on the screen are cleared beginning with the starting line 
number. 

The following keywords are ignored if the starting line number has changed 
since the last output operation: 

ERRMSG 

ERRMSGID 

PUTOVR 

PUTRETAIN 

The SLNO keyword is invalid in a record format that has only hidden or 
message fields or that has no fields specified. It is also invalid in a record 
format that has one of the following keywords specified: 

ASSUME 

KEEP 

SFL 

SFLCTL 

USRDFN 

The SLNO keyword cannot be specified for the record format specified by the 
PASSRCD keyword. 

Option indicators are not valid for this keyword. 
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The following example shows how to specify the SLNO keyword: 
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BT 
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In this example, when the starting line number is zero or one, 
FIELD1 is displayed on line 2 and FIELD2 is displayed on line 
3, as specified. When the starting line number is set to 2 in 
your program, FIELD1 is displayed on line 3 (2 - 1 + 2 = 3) 
and FIELD2 is displayed on line 4 (2 - 1 + 3 = 4). 


FIELD3 and FIELD4 are always displayed on line 11 (2 - 1 + 
10 = 11). 
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TEXT('description') 


Use this record or field level keyword to supply a text description (or comment) 
for the record format or field. The text is used for program documentation. 

If the length of the text is greater than 50 positions, only the first 50 
characters are used by the high-level language compiler. 

The TEXT keyword is valid for any record format or named field. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the TEXT keyword at the record 
and field levels: 
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TIME 


Use this field level keyword to specify that CPF is to retrieve the current 
system time and display It in a constant field. The time is retrieved each time 
your program issues an output operation. The following information is implied: 

• The output-only attribute 

• Numeric-only data type 

• The edit word 'Ob:bb:bb' (If no editing is specified, this edit word is 
assumed.) 

• A display length of 8 positions 

You can specify only the location of the field on the screen. Positions 17 
through 38 must be blank. 

You can also specify a different edit word (for example, 
EDTWRD('ObHRS:bbMINS:bbSECS.')) or one of the user-defined edit 
codes to be used in place of the implied edit word (see EDTCDE and EDTWRD 
keywords). 

Option indicators are not valid with this keyword. 

The TIME keyword is not valid for subfile records. 

The following example shows how to specify the TIME keyword: 
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UNLOCK[(*ERASE) | (*MDTOFF)] | [(«ERASE *MDTOFF)l | [(*MDTOFF *ERASE)J 

Use this record level keyword to specify that CPF is to unlock the keyboard 
immediately after issuing an input operation to the record format you are 
defining. 

Without the UNLOCK keyword, CPF leaves the keyboard locked after reading 
the data on the display. The work station user cannot key data into 
input-capable fields while the data that has just been read is being processed. 

The parameter values *ERASE and *MDTOFF are optional. If you do not 
specify any parameter value, *ERASE is the default. 

When your program issues an Input operation, the following sequence of 
operations usually occurs. The keyboard is unlocked (if it is not already 
unlocked) to allow the work station user to key into input-capable fields on the 
display. Then the work station user presses the Enter/Rec Adv key (or a valid 
command key). Input-capable fields In the record format have their modified 
data tags (MDTs) set on if they have been keyed into or if they were displayed 
with the DSPATR(MDT) keyword in effect. When the input operation is 
completed, the parameter values on the UNLOCK keyword affect the 
input-capable fields with MDTs set on as follows. 


UNLOCK (without GETRETAIN) or UNLOCK(^ERASE): The keyboard remains 
unlocked, input-capable fields on the display are erased, and their MDTs are 
not reset following the input operation. 


UNLOCK(^MDTOFF) or UNLOCK (with GETRETAIN): The keyboard remains 
unlocked, input-capable fields on the display are not erased, and their MDTs 
are reset following the input operation. 


UNLOCK(*ERASE *MDTOFF) or UNLOCK(*MDTOFF *ERASE): The keyboard 
remains unlocked, input-capable fields on the display with their MDTs set on 
are erased, and their MDTs are reset following the input operation. 

The GETRETAIN keyword is ignored and an error message results at file 
creation time If GETRETAIN is specified with UNLOCK(any parameter). 

Note: This keyword does not prevent your program from issuing an output 
operation immediately after an input operation. However, the keyboard is 
unlocked and the work station user could be keying input data when the output 
operation changes the display. 

Option indicators are not valid with this keyword. 
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USRDFN 

Use this record level keyword to specify that the data for this record is in the 
form of a user-defined data stream. No fields are valid for this record because 
the data stream formats the screen. No file, record, or field level keywords 
apply to this record except PASSRCD, KEEP, PRINT, OPENPRT, TEXT, and the 
routing keywords. Once you do an output operation for this record, CPF no 
longer retains knowledge of the status of the records on the device. You 
should have in-depth knowledge of the device before using this keyword. 

Option indicators are not valid with this keyword. 

For more information on how to use this function, see the CPF Programmer's 
Guide. 

The following example shows how to specify the USRDFN keyword: 



4-206 























































































VALUES(value-1 [value-2... [value-20]]) 
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Use this field level keyword to specify a list of values that are valid for the user 
to enter into the field; CPF performs an implied equals test on the data entered 
against the vaiue(s) you specify here. 

The following example shows how to specify the VALUES keyword for a 
character and numeric values test: 
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There can be 1 to 20 values; specify them as parameter values with the 
keyword and separate them by at least one blank. 

A value can be a numeric or a character literal, corresponding in length to the 
field that is to be tested. A character literal must be enclosed in apostrophes; 
a numeric literal is restricted to the digits 0 through 9 and can be preceded by 
a minus sign (-) for negative values. Alignment is on the low-order character 
position. 

The compare is based on the value as it is passed to your program (for 
example, right-adjusted and padded, or left-adjusted and padded). 

Option indicators are not valid with this' keyword. 

Note: If the value specified is a constant and the field named (to be compared 
with) is a numeric field, alignment is based on the decimal precision specified, 
and the leading and trailing blanks are filled with zeros. If no decimal point is 
specified, the decimal point is assumed to be to the right of the last (rightmost) 
digit. For example, for a numeric field with a length of 5 (specified in column 
34) and 2 decimal positions (specified in column 37), 1.2 is interpreted as 
001.20, and 100 is interpreted as 100.00. 
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Display Files 
VLDCMDKEY 


VLDCMDKEY(response-indicator ['text']) 


Use this file or record level keyword to specify that CPF is to set on the 
specified response indicator when any valid command key other than the 
Enter/Rec Adv key is pressed by the work station user. 

One use of this function is to perform a simple test to determine if the work 
station user has requested a function you want to watch for in your program. 


For a command key to be considered valid, you must have enabled the key by 
specifying it with one of the following keywords: 


Keyword Comments 


CAnn 

CFnn 

CLEAR 

HELP 

HOME 

PRINT 

ROLLUP 

ROLLDOWN 


With or without response indicator 
With or without response indicator 
With or without response indicator 
With or without response indicator 
With or without response indicator 
Only with a response indicator 
With or without response indicator 
With or without response indicator 


The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 

Option indicators are not valid with this keyword. 


The following example shows how to specify the VLDCMDKEY keyword: 
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In this example, indicator 90 is set on if any of four keys (01, 02, 03, 
or Clear) is pressed. 
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Chapter 5. Printer Files 


This chapter is divided into two sections. The first Positional Entries, provides 
rules and examples for filling in positions 1 through 44 of the Data Description 
Specifications form. To find information in this section, first determine what 
position on the form to use, then look up the section describing that position. 

The second section of this chapter. Keyword Entries, provides rules and 
examples for specifying DDS keywords. The keywords are described in 
alphabetical order. 

For guidance in choosing positional entries and keywords for printer files, see 
the CPF Programmer's Guide. 

When you are describing a printer file, specify the entries in the following 
order: 

1. File level entries (optional) 

2. Record level entries 'I Repeat these entries for 

> each record format in 

3. Field level entries I the file. 

You must specify at least one record format in the file and at least one field in 
each record format. 

Note: The file name is specified through the Create Printer File (CRTPRTF) 
command, not through DDS. 

Complete printer file examples can be found In Appendix F, Examples. 

An explanation of file level, record level, and field level can be found in Chapter 
1, Introduction. 

The syntax rules for specifying DDS keywords can be found In Chapter 1, 
Introduction. 

The maximum number of record formats in a printer file is 1024. The 
maximum number of fields In any one record format is 32 767. The maximum 
combined length of all named fields and indicators in a record format is 
32 767. 
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Figure 5-1. Printer File Coding Example 



























Positional Entries (Positions 1-44) 


Printer Files 
Positions 1-5 


This section describes how to specify the first 44 positions of the Data 
Description Specifications form for printer files. To code the rest of the form, 
see the section Keyword Entries (Functions Field, Positions 45-80) later in this 
chapter. 

Figure 5-1 shows some positional entries for printer files. 


Positions 1-5 (Sequence Number) 

Use these positions to specify a sequence number for each line on the form. 
The sequence number is optional and is used for documentation purposes only. 


Position 6 (Form Type) 

The A in this position designates this as a Data Description Specifications 
form. The form type is optional and is for documentation purposes only. 


Position 7 (Comment) 

An asterisk (*) in position 7 identifies the line as a comment line. Comment 
lines can appear anywhere in DDS and are retained only in the source file and 
printed on the source listing. (Comments are not printed on the expanded 
source listing.) Use positions 8 through 80 for comment text. A blank line (no 
characters specified in positions 7 through 80) is treated as a comment line. 


Positions 7-16 (Conditioning) 

Positions 7 through 16 are a multiple-field area in which you can specify 
option indicators. Option indicators are two-digit numbers from 01 to 99. Your 
program can set option indicators on (hex FI) or off (hex FO) to select a field 
or keyword. 

A condition is an ANDed grouping of one to nine indicators that must all be in 
effect (set off if N is specified; set on if N is not specified) before the field or 
the keyword is selected. You can specify a maximum of nine Indicators for 
each condition and nine conditions for each field or keyword; therefore, a 
maximum of 81 indicators can be specified for each keyword, when nine 
indicators are used with nine conditions. 

When you specify a condition so that more than one indicator must be on or 
off before the condition is satisfied, it is called an AND condition; you are 
essentially saying that the first indicator you specified, AND the second, AND 
the third, and so on, must all be in effect before the condition is satisfied 
and the field or the keyword is selected. The field or the keyword must be 
specified on the same line as the last (or only) set of indicators specified. 
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Printer Files 

Positions 7-16 


You can also specify several conditions for the field or the keyword so that if 
any one of them is satisfied, the field or the keyword Is selected. This is called 
an OR relationship, and it means that if the first condition is satisfied, OR the 
second condition, OR the third condition, and so on, the field or the keyword is 
to be selected. Note that conditions within the OR relationship can consist of 
just one indicator or can consist of several indicators ANDed together. 
Indicators can be ANDed to form a condition; conditions can be ORed to give 
your program several ways to select the field or the keyword. 


AND (Position 7): If you need more than three indicators to form an ANDed 
condition, specify them In the same positions on the next line or lines. You can 
specify A in position 7 on the second or following lines to designate the 
continuation of the AND condition, or you can leave it blank because A Is the 
default. 


OR (Position 7): If you specify several conditions that are to be ORed together, 
each condition must start on a new line and each condition except the first 
must have an 0 in position 7. An O specified for the first condition produces a 
warning message, and that position is assumed to be blank. 


NOT (Positions 8, 11, 14): If you want an Indicator to be off Instead of on to 
satisfy a condition, specify N in the position just preceding the Indicator 
(position 8, 11, or 14). 


Conditioning More Than One Field or Keyword: If you are conditioning a field, 
the field name (or the constant) and the last (or only) indicator must be on the 
same line. If you specify one or more keywords for the field, only the field is 
conditioned, not the keyword(s). If the field is not selected for an output 
operation, no keywords specified for that field are in effect, regardless of how 
the keywords are conditioned. For example, in Figure 5-1, if indicator 30 is 
off, SPACEA and UNDERLINE are not in effect. 

If you want to condition one or more keywords, specify the last (or only) 
indicator on the same line as the keyword(s) and specify the keywords on the 
same line. If the conditioning applies to keywords on more than one line, 
keyword continuation must be used for the indicators to apply to all the 
keywords. See Data Description Specifications Syntax Rules in Chapter 1, 
Introduction. 
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Position 17 (Name Type) 


Printer Files 

Position 17 


The value in this position identifies the type of name in positions 19 through 
28 (name). The valid entries for printer files are: 


Entry Meaning 

R j Record format name 

Blank Field name 

Figure 5-1 shows how to code the name type. 

Position 18 (Reserved) 

This position does not apply to any file and must be blank unless an asterisk 
appears in position 7 (indicates a comment line). 


Positions 19-28 (Name) 

Use these positions to specify record format names and field names. The 
following rules apply: 

• Names must be 10 characters or less. 

• Names must start in position 19. 

• Names must begin with an alphabetic character (A through Z, $, and #). 

All subsequent characters can be alphameric (A through Z, 0 through 9, @, 
$, #, and underscore (_)). There can be no embedded blanks. 

Figure 5-1 shows how to code the name field. 

High-level languages can impose specific length and value restrictions on 
names. It is your responsibility to make sure that the names used here are 
acceptable to all language processors that process the file. 


Record Format Name: When you specify R in position 17 (name type), the 
name specified in positions 19 through 28 is a record format name. You can 
specify more than one record format for a printer file, but each record format 
name must be unique within that file. You must specify field names or 
constant fields to complete a record format in a printer file. 


Field Name: When you specify a blank in position 17 (name type), the name 
specified in positions 19 through 28 is a field name. Field names must be 
unique within the record format. 
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Printer Files 

Positions 19 "28 


Constant Fields: Constant fields are unnamed fields (positions 19 through 28 
must be blank). Further, the following rules apply to constant fields: 

• Positions 17 through 38 must be blank. 

• The location of the field is required (positions 39 through 44). 

• The field can be conditioned using option indicators (positions 7 through 
16). 

• The constant itself is defined using one of the following entries: 

- Explicit DFT keyword (specify the literal within apostrophes with the DFT 
keyword) 

-- Implicit DFT keyword (specify the literal within apostrophes without the 
DFT keyword) 

- DATE keyword (specify no literal; see the DAYe keyword description) 

- TIME keyword (specify no literal; see the TIME keyword description) 

- PAGNBR keyword (specify no literal; see the PAGNBR keyword 
description) 

• The EDTCDE or the EDTWRD keyword can be specified only when DATE, 
TIME, or PAGNBR is also specified. 

You must specify the fields In the order in which they are to appear on the 
printed page unless you specify line numbers. If you use line numbers, you can 
specify the fields in any order. 
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Printer Files 

Position 29 


Specify R in this position to use the reference function of CPF to copy the 
attributes of a previously defined named field (called the referenced field) to the 
field you are defining now. The referenced field can be previously defined in 
the printer file you are defining; or it can be in a previously created data base 
file (the data base file to be referenced is specified on the REF or REFFLD 
keywords). The field attributes referenced are the length, the data type, and 
the decimal positions of the field, as well as editing and text keywords. 

If you do not specify R, you cannot use the reference function for this field and 
you must specify field attributes for this field. 

Position 29 must be blank at the file and record levels. 

The name of the referenced field can be either the same as the field you are 
defining or different from the field you are defining. If It is the same, you need 
only specify R in position 29 in addition to specifying the name of the field you 
are defining in positions 19 through 28. If it is different, you must specify the 
name of the referenced field with the REFFLD keyword. 

You can specify the name of the file defining the referenced field as a 
parameter value with the REF or the REFFLD keyword. See REF and REFFLD 
keyword descriptions later In this chapter and Appendix A, How to Specify REF 
and REFFLD, for explanations of how CPF finds the referenced field. 

You do not need to copy all attributes from the previously defined field to the 
field you are defining. To override specific attributes of the referenced field, 
specify those attributes for the field you are defining, as follows: 

• To override editing keywords (EDTCDE or EDTWRD), specify EDTCDE or 
EDTWRD for the field you are defining. (You can simply delete these 
keywords by specifying DLTEDT for the field you are defining.) 

• Validity checking keywords (CHECK, COMP, RANGE, VALUES), if specified 
for the referenced field, are Ignored in the printer file. 

When you override some specifications, others are also affected, as follows: 

• If you specify a value for data type, field length, or decimal positions for the 
field you are defining, editing keywords are not copied from the referenced 
field. 

• Packed decimal and binary fields are not supported for printer files; 
therefore, when you reference fields of these types, the data type is 
converted to zoned decimal (S in position 35) In the printer file. 

Note: Once the printer file is created, the referenced file can be deleted or 
changed without affecting the field definitions in the printer file. To incorporate 
changes made In the referenced file, delete and re-create the printer file. 
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Printer Files 

Positions 30-34 


Positions 30-34 (Field Length) 


You must specify a field length for each named field unless it is being 
duplicated from a referenced field. Your entry here represents the number of 
bytes of data to be passed from your program when an output operation is 
done for this field. (If the field is to be edited, the associated edit code or edit 
word is used to determine the printed length of the field.) Figure 5-1 shows 
how to code the field length. 

The maximum length of a zoned decimal field is 31. Data description 
specifications allow a maximum field length of 32 767 characters. If the field 
length causes the field to extend beyond the form size, a warning diagnostic Is 
issued. 

When you specify this field, the entry must be right-justified; leading zeros are 
optional. 

If you are using a referenced field, you can override the length of the field by 
specifying a new value or by specifying the increase or decrease In length. To 
increase the length, specify +n, where n is the Increase. To decrease the 
length, specify -n, where n is the decrease. For example, an entry of +4 
indicates that the field is to be 4 digits longer than the referenced field. The 
field length can be overridden without overriding the decimals. 

The following example shows valid and invalid field length specifications: 
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Position 35 (Data Type) 

Specify in this position the data type associated with the field. The valid 
entries for this field for a printer file are: 

Entry Meaning 

S Zoned decimal 

A Character 

If you do not specify a data type and do not duplicate one from a referenced 
field, CPF assigns a default value as follows: 

• A (character) if the decimal positions (36 through 37) are blank 

• S (zoned decimal) if the decimal positions (36 through 37) contain a number 
in the range 0 through 31 

Note: Placing 0 In position 37 is a convenient way to specify an integer 
numeric field. 

Figure 5-1 shows how to code the data type. 


Positions 36-37 (Decimal Positions) 

Use these positions to specify the decimal placement within a zoned decimal 
field and also to specify the data type of the field as It appears In your 
program. 

If you leave these positions blank, CPF assumes a data type of character for 
the field. 

If you enter a number in these positions, CPF assumes a data type of zoned 
decimal for the field. The number specified is the number of positions to the 
right of the decimal point; it must be less than or equal to the field length, with 
a maximum of 31. Figure 5-1 shows how to code decimal positions. 

If you are using a referenced field, you need not specify decimal positions. The 
information is retrieved from the referenced file. The decimals retrieved can be 
either overridden or changed. To override the decimal positions, specify the 
new value explicitly. To change the decimal positions, specify the amount you 
want the field increased or decreased and precede it with either + or -, 
respectively. For example, an entry of +4 indicates there are four more digits 
to the right of the decimal point than in the referenced field. 


Position 38 (Usage) 

The only valid entries for this field are either blank or 0, and either entry means 
output only. 


Printer Files 

Position 35 


Printer Files 
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Printer Files 
Positions 39-44 


Positions 39-44 (Location) 


Use these positions to specify the exact location on the page where the 

beginning of the field appears. The following conditions apply: 

• When line numbers are specified, fields can appear in any order. They will 
be resequenced into line-position order when placed in the printer file. 

• When line numbers are not specified, the field ordering within the printer file 
is the same as specified in the DOS. 

• When fields or space/skip keywords are conditioned, they are treated as if 
they were selected when performing overlap checks. 

• In a record format having several fields, when a field that has skip/space 
keywords is conditioned or a field-level skip/space keyword is conditioned, 
a warning message is issued indicating that overlapping fields could occur 
and not be diagnosed. 

• When the form size is exceeded because of a field's length, location, or 
associated skip/space keywords, or a combination of these, a warning 
message is issued. 

• The maximum value for line number is 255. The maximum value for position 
number depends on the characters-per-inch (CPI) parameter on the Create 
Printer File (CRTPRTF) command. If that value is 10, which is the default, 
the maximum is 132; If it is 15, the maximum is 198. 

• The overflow line (the last printed line on a page) depends on the OVRFLW 
and FORMSIZE parameters on the Create Printer File (CRTPRTF), Change 
Printer File (CHGPRTF), and Override with Printer File (OVRPRTF) 
commands. For externally described files, RPG cannot control page 
overflow. See the CPF Programmer's Guide for input/output considerations 
regarding the overflow line. 

• When externally described files are used by high-level language compilers, 
the fields are sequenced in the output record area according to the DOS. 
Refer to the appropriate high-level language manual for specific information, 
if fields overlap, the printer overprints. See the expanded source in the 
compiler listing generated by the Create Printer File (CRTPRTF) command 
for field lengths and output buffer positions. 
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Printer Files 
Positions 39-44 


Positions 39-41 (Line): The entry you make in these positions specifies the 
line on the page in which the field begins. The entry must be right-justified; 
leading zeros are optional. Line numbers can be specified for either named or 
unnamed fields within a record; if you specify a line number for one field 
within a record, you must specify either a line number in positions 39 through 
41 or an increment (+n) in positions 42 through 44 for a// fields within that 
record. 

Line numbers are not valid if one of the skip or space keywords has been 
specified at either the record level or field level. Line numbers are valid, 
however, if one of the skip keywords has been specified at the file level. 
(Space keywords are not valid at the file level.) 


Positions 42-44 (Position): The entry you make here specifies the starting 
position of the field. It must be right-justified; leading zeros are optional. 

If you specify a location of a field In a record and the field is not ignored, you 
can specify the location of subsequent fields within that record by leaving the 
line number blank and specifying an increment (+n) for 42 through 44 (position 
entry). The Increment indicates the number of spaces to be left between the 
end of the previous field and the beginning of the field you are defining. If you 
specify an increment, the line number entry must be blank. Note that if the 
increment causes an implicit space operation, and line numbers are not being 
used for the record format, then skip/space keywords must be used to cause 
spacing to occur. The following example illustrates this problem and two 
possible solutions (for a form width of 132 characters): 
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2 
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Condition Name 
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o 
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o 

2 
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Line 

39 40 41 
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AC 
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A 

1 

P 
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B 

w 

iM 

B 

m 

1 

■ 

1 
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II 

iH 

1 
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1 

1 

1 

1 

BB 

■ 

■ 
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B 

B 

B 




1 

Bi’ 



n 
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1 



* 
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n 
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1 





1 

fl 
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■ 



B 

fl 
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fM 

'H 


/so 






1 
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B 


B 

B 

B 

fl 

BB 
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B 

BI 
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m 
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1 

■H 
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1 
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1 

mi 
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m 
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B 

fl 

BB 

fl 

B 

BI 

II 
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II 

II 

1 
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1 
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m 

B 

1 
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1 
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B 

1 
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Printer FiSes 

Positions 39-44 Any field that extends beyond the end of a line is continued on the next line. 

The break occurs at the end of the line but you can cause it to be folded at a 
blank by specifying the BLKFOLD keyword. This assumes that FOLD(*YES) is 
in effect for the file (see CRTPRTF, CHGPRTF, and OVRPRTF commands in the 
CL Reference Manual). 

The data description specifications determine which fields appear on the same 
print line. The data description processor diagnoses overlap at file creation 
time if it occurs. Keywords or fields containing keywords that are optioned are 
assumed to be selected. Therefore, no overlap check is made for the cases 
where the keywords or fields are not selected. In the following example, no 
fields would overlap unless indicator 01 is on, in which case FI, F3, and F4 
would overlap. A diagnostic is issued for the format indicating that field 
selection or conditioning of space/skip keywords can cause fields to overlap at 
execution time. 


Br 



Conditioning 

:: Name Type {«/R/K/S/0) I 

« Reserved I 

Name 

19 20 21 22 23 24 25 26 27 28 

<o Reference (R) 

Length 

30 31 32 33 34 

^ Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

ii 

si 

36 37 

s 

I 

m 

5 

- 

8> 

S 

D 

38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 6566 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

12 3 4 

5 

8L 

E 

& 

6 

And/Or/Comment (A/0/*) 

2 

s 

2 

8 

Condition Name 

1 

c 

9 10 

- Not IN) 

1 

s 

12 13 

2 

i 

14 

o 

S 
1 
15 16 

Line 

39 40 41 

Pos 

42 43 44 
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A 
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Printer Files 

Keyword Entries 


Keyword Entries (Positions 45-80) 


This section contains keyword entries valid for defining printer files. They are 
entered in positions 45 through 80 (functions). 

See the section on Data Description Specifications Syntax Rules in Chapter 1 for a 
discussion of the general rules for specifying keywords. Figure 5-2 shows how 
to use the general rules to specify DOS for printer files: 






inm 





gSSSSDni 


BggggBMI 

i^H BIBI 

laabk BIBI 

gaBB BIH 

SgBgaBHI 

^^ BMI 

gSgEB BIH 

gaagsBiBi 




■■II 
■■11 






mmimKmamsi 


IBB iaPTOjEl MMI 

■■■ 


iniHii 


mWWSBMiJii 
nWKSMMmi 


msmiWMmwmm 



mi 


IIM 


■■11 


ll■IK]| 


ll^l 



You can specify option indicators 
in the boxed-in positions. 


Figure 5-2. Syntax for a Printer File 
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Printer Fifes 
BLKFOLD 


The following keywords are valid for printer files: 


BLKFOLD 

DATE 

DFT 

DLTEDT 

EDTCDE 

EDTWRD 

INDTXT 

PAGNBR 

REF 

REFFLD 

SKI PA 

SKIPB 

SPACEA 

SPACER 

TEXT 

TIME 

UNDERLINE 


BLKFOLD 

Use this field level keyword (blank fold) for named fields that overflow onto 
subsequent print lines, to cause folding to occur at a blank rather than at the 
end of a line. The default is to fold at the end of the physical print line. 

When you use this keyword, the field length is not increased; therefore, a 
portion of the output data might be truncated. 

Option indicators are not valid with this keyword although option indicators can 
be used to condition the field (whether named or constant) with which it is. 
associated. 

The following example shows how to specify the BLKFOLD keyword: 


HT” 


Conditioning 

§ 

.2: 

1 

17 

a Reserved 

Name 

I 

j 

1 

i 

0 

19 20 21 22 23 24 2S 26 27 28 2 

Length 

: 

s 

» 

e 

1 

9 30 31 32 33 34 

g Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

S Decimal 
“ Positions 

1 

e 

1 

1 

38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 S 

® Form Type 

1 

1 

s 

7 

2 

? 

2 

8 

Condition Name 

1 

1 

9 10 

2 

s 

2 

1 

1 

12 13 

2 

1 

14 

^ Indicator 

Line 

39 4041 

Pos 

42 43 44 

(mi 


A 

“1 










mmi 



Tm 

g 



LU 


mMmL 

T>l 









n 


n 







“1 










mTm 

M M i 











It 


















MM M M i 
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DATE 


Printer Files 
DATE 


Use this field level keyword to specify that CPF is to retrieve the current job 
date (the date the job was started) and print it in a constant field. The 
following information is implied for the field and you cannot specify it: 

• The output-only attribute 

• A field length of 6 positions 

You must specify only the location of the field on the page. Positions 17 
through 38 must be blank. 

You can optionally specify an edit code or an edit word for this field (see the 
EDTCDE and EDTWRD keywords). If no edit code or edit word keyword is 
specified, no editing takes place. 

Option indicators are not valid for this keyword. 

Notes: 

1. The Y edit code uses the character In the system value QDATSEP, as the 
date separator character. When DATE and EDTCDE(Y) are specified 
together on a constant (unnamed) field, the data is edited according to the 
system values QDATSEP (date separator character) and QDATFMT (date 
format). See the description of the EDTCDE keyword for more information 
on how the date is edited. 

2. At execution time, if QDATFMT is JUL (Julian), and any edit code is 
specified, CPF puts a zero in the sixth position. EDTCDE(Y) should be used. 

The following example shows how to specify the DATE keyword: 
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Printer Files 
DFT 


DFT('literal') | ('literal') 


Use this field level keyword to specify the constant value for constant fields 
(unnamed fields). The specified literal must be enclosed in apostrophes. 


If you omit the DFT keyword, specifying the literal by itself (still within 
apostrophes) implies the DFT keyword. Specifying the DFT keyword implicitly 
or explicitly for constant fields provides the same function. 

When you specify the DFT keyword, whether implicitly or explicitly, the number 
of characters between apostrophes is the length of the constant field (except 
when you specify double apostrophes within the constant; the double 
apostrophes appear as one apostrophe). 

Option indicators are not valid with this keyword, although option indicators 
can be used to condition the constant field with which it is specified. 


The following example shows how to specify the DFT keyword: 


QT" 


Conditioning 

Name Type (li)/R/K/S/0) 

00 Reserved 

Name 

19 20 21 22 23 24 25 26 27 28 

Eg Reference (R) 

Length 

30 31 32 33 34 

1 

z 

> 

>< 

CO 

uS 

1 

& 

> 

o 

35 

l| 

11 
36 37 

g Usage (B/O/l/B/H/M) 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

12 3 4 5 

® Form Type 

'J And/Or/Comment (A/0/*) 

z 

S 

z 

8 

Condition Name 

<0 

Indicator 

o 

z 

o 

z 

[j Indicator 

z 

o 

z 

14 

i 

1 

15 16 

Line 

39 40 41 

Pos 

42 43 44 

000X0 

A 










n 

R 


sapPLi 

E 

5 















0002.0 

A 













P6MS 







2.^ 




2L 


1 

DIF 

T 



00030 

A 



















ZP 
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1 

X> 
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T 

C BVoea 


00040 
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00070 
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OOiiOO 
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The specifications DFT('ON') and 'ON' are equivalent and show the 
difference between specifying the DFT keyword explicityly and implicity. 


If indicator 01 is on, the following is printed: 

Hotel name: Terrace Inn' 

If Indicator 02 is on and Indicator 01 Is off, the following is printed: 
Hotel name: 'Riverview Inn' 
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Printer Files 
DLTEDT 


If a field description is duplicated from a data base file, this field level keyword 
prevents certain information from being duplicated. Use it to specify that CPF 
is to ignore any edit code or edit word keywords that were specified for the 
referenced field. 

This keyword is valid only when you have specified R in position 29 for this 
field, and have also specified either the REF or the REFFLD keyword. 

If replacement edit information is needed, simply specify the EDTCDE or the 
EDTWRD keyword for the field you are defining; the new keyword overrides 
the editing from the referenced field. In this case you do not need to specify 
the DLTEDT keyword. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the DLTEDT keyword: 





ID 


Name 

19 20 21 22 23 24 25 26 27 28 

« Reference (R) 

Length 

30 31 32 33 34 

S Data Type (b A/P/S/B A/S/X/Y/N/l/W> 

ii 

11 
38 37 

s 

1 

5 

i 

38 


Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 7576 77 78 79 80 

Stquenoe 

Number 

1 2 3 4 s 

& 

E 

5 

6 

1 
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1 

7 
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1 

8 
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10 

z 
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12 13 

n 
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1 

14 

I 

1 
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1 
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Q 

■ 
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■ 
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1 

B 

■ 
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IB 

Bl 

i3 
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1 
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Printer Files 
EDTCDE 


EDTCDEfedit-code [* | floating-currency-symbol]) 

Use this field level keyword to specify an edit code for editing of output data 
for a numeric field using this current field description. An edit code is a 
required parameter for this keyword. 

EDTCDE is valid only for numeric fields. Both EDTCDE and EDTWRD 
keywords cannot be specified for the same field. You can use the EDTCDE 
keyword to perform edit functions such as the following: 

• Suppress leading zeros 

• Omit a sign from the low-order position of the field 

• Punctuate the field without having to specify an edit word (see the 
EDTWRD keyword) 

• Perform asterisk fill 

• Specify floating currency symbol (this symbol must correspond to the 
system value QCURSYM) 

• Perform user-defined edit functions 

Option indicators are not valid with this keyword. 


CPF Edit Codes: The edit codes that you can specify as a parameter value for 
this keyword are: 

1 through 4 
A through D 
J through M 
Yand Z 

Edit code X has no effect in printer files. For an explanation of its use, see the 
EDTCDE keyword descriptions in Chapter 2, Physical Files and Chapter 3, 
Logical Files. 
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The following chart summarizes the functions provided by CPF edit codes. A 
negative field can be punctuated with no sign, CR (credit), or a minus. 


Printer Files 
EDTCDE 


Edit 

Code 

Commas^ 

Printed 

Decimal 

Points^ 

Printed 

Signs Printed When Negative 
Number 

Zero 

Balance 

Printed 

Leading Zero 
Suppressed 

No Sign 

CR 

- (Minus) 

1 

Yes 

Yes 

No sign 



Yes 

Yes 

2 

Yes 

Yes 

No sign 




Yes 

3 


Yes 

No sign 



Yes 

Yes 

4 


Yes 

No sign 




Yes 

A 

Yes 

Yes 


CR 


Yes 

Yes 

B 

Yes 

Yes 


CR 



Yes 

C 


Yes 


CR 


Yes 

Yes 

D 


Yes 


CR 



Yes 

■■ 

Yes 

Yes 



__ 

Yes 

Yes 

mm 

Yes 

Yes 





Yes 

L 


Yes 



__ 

Yes 

Yes 

M 


Yes 



_ 


Yes 

Y2 







Yes 

Z3 







Yes 


^The QDECFMT system value determines the decimal point character (period in U.S. usage), the character used 
to separate groups of three digits (comma in U.S. usage), and the type of zero suppression (depending on 
comma and period placement). See the CPF Programmer's Guide for detailed instructions. 

^The Y edit code suppresses the leftmost zero of a date field that Is three to six digits long, and it suppresses 
the two leftmost zeros of a field that is seven positions long. The Y edit code also inserts slashes (/) between 
the month, day, and year according to the following pattern: 
nn/n 
nn/nn 
nn/nn/n 
nn/nn/nn 
nnn/nn/nn 

If the DATE keyword is specified with EDTCDE(Y), the separator character used is the system value, 

QDATSEP. The slash (/) is the default QDATSEP. If QDATFMT is JUL (Julian), the data is normally formatted 
as: nn/nnn. 

^The Z edit code removes the sign (plus or minus) from a numeric field. The sign of the units position is 
changed to a hexadecimal F before the field is written. 
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EDTCDE 


User-Defined Edit Codes: You can also specify any of the five user-defined 
edit codes (5 through 9). Before creating a device file from DDS source 
containing user-defined edit codes, you must create and define the 
user-defined edit codes using the Create Edit Description (CRTEDTD) 
command. When you create the printer file, the editing information is extracted 
from the user-defined edit codes as referenced in the DDS. Changing 
user-defined edit codes does not affect existing device files unless the device 
files are re-created. See the CPF Programmer's Guide and the CL Reference 
Manuai for a description of how to create user-defined edit codes. 


Asterisk Fiii and/or Floating Currency Symbol: You can optionally specify 
asterisk fill and/or floating currency symbol with edit codes 1 through 4, A 
through D, and J through M. 

When you specify asterisk fill, an asterisk (*) is written for each zero 
suppressed. A complete field of asterisks is printed for a zero balance field. 

When you specify floating currency symbol, the symbol appears to the left of 
the first significant digit. The symbol does not print on a zero balance when an 
edit code is used that suppresses the zero balance. The symbol that you 
specify must match the system value for the floating currency symbol. (The 
symbol must match when the file is created; it does not have to match when 
the file is used.) 

Note: If an edit code is changed after a file Is created, the editing specified at 
the time the file was created is used. The new edit code is not used unless 
the file was re-created. 

Figure 5-3 shows valid edit codes with examples of unedited source data and 
edited output. The zero suppression and decimal characters are determined by 
the system value QDECFMT. The date separator character is determined by 
the system value QDATSEP. In this figure, QDECFMT is assumed to equal b, 
and QDATSEP is assumed to equal /. 
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EDTCDE 


Edit Codes 

Positive 

Number- 

Two 

Decimal 

Positions 

Positive 
Number- 
No Decimal 
Positions 

Negative 

Number- 

Three 

Decimal 

Positions^ 

Negative 
Number- 
No Decimal 
Positions^ 

Zero 

Balance- 

Two 

Decimal 

Positions 

Zero Balance- 
No Decimal 
Positions 

Unedited 

1234567 


6B6126 

B6612B 

000000 

000000 

1 

12,345.67 


.120 

120 

.00 

0 

2 

12,345.67 

1,234,567 

.120 

120 



3 

12345.67 

1234567 


120 

.00 

0 

4 

12345.67 

1234567 


120 



A 

12,345.67 

1,234,567 


120CR 

.00 

0 

B 


1,234,567 


120CR 



c 

12345.67 

1234567 

.120CR 

120CR 

.00 

0 

D 


1234567 

.120CR 

120CR 



imm 

IIRiffilSiS 

1,234,567 

.120- 

120- 

.00 

0 

K 


1,234,567 

.120- 

120- 



L 


1234567 

.120- 

120- 

.00 

0 

M 


1234567 

.120- 

120- 



Y2 


123/45/67 

0/01/20 

0/01/20 

0/00/00 

0/00/00 

Z3 

1234567 

1234567 

120 

120 



^The 5 represents a blank. This may occur if a negative zero does not correspond to a printable character. 

^The Y edit code suppresses the leftmost zero of a date field that is three to six digits long, and it suppresses 
the two leftmost zeros of a field that is seven positions long. For more information, see the description of this 
edit code under CPF Edit Codes in this keyword description. 

^The Z edit code removes the sign (plus or minus) from a numeric field and suppresses leading zeros of a 
numeric field. 


Figure 5-3. Valid Edit Codes, Source Data, and Edited Output 

The following example shows how to specify the EDTCDE keyword: 




Conditioning 

Name Type (M/R/K/S/0) I 

m Reserved I 

Name 

19 20 21 22 23 24 25 26 27 28 

(D Reference (R) 

Length 

30 31 32 33 34 

g Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

^ Decimal 

Positions 

8 Usage («/0/l/B/H/M) 

Location 

Functions 

46 46 47 48 49 50 51 52 53 64 65 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 76 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5, 

® Form Type 
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1 

1 

1 

5 

7 

i 

s 

z 

8 

Condition Name 

(0 

^ indicator 
o 

z 

S 

z 

11 

indicator 

z 

1 

14 

1 

1 

16 16 

Line 

39 40 41 

Pos 

42 43 44 


Q 

1 

1 

■ 


i 








1 

HHK 

■ 

e 

1 


IE 

SEEuMijESa 

—— 




HI 

1' 


□ 

1 

1 

■ 

1 

■ 

1 

■ 

I 

1 


■ 

■ 

1 

HHH 

1 

B 

1 






B 

WiMMli 
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1' 
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r 

m 

n 

m 

n 

rr 
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r 
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m 

m 

n 
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r 
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Printer Files 
EDTWRD 


EDTWRD('edit-word') 

If you cannot accomplish the desired editing by using the EDTCDE keyword, 
you can specify an edit word instead. Make it up according to the rules listed 
below. The edit word specifies the form in which the field values are to be 
printed and clarifies the data by inserting characters directly, such as decimal 
points, commas, floating and fixed currency symbol, and credit balance 
indicators. It can also be used to suppress leading zeros and to provide 
asterisk fill protection. 

Use the following rules to specify a valid edit word: 

• Enclose the edit word in apostrophes. 

• The EDTWRD keyword is valid only for numeric fields. 

• The number of replaceable characters in the edit word must equal the length 
of the field. 

• When using the floating currency symbol, the sum of the number of blanks 
and the stop-zero-suppression character (digit positions) contained in the 
edit word must be equal to the number of positions In the field to be edited. 
The currency symbol is not counted as a digit position. For example, if you 
specify a field length of 7 with 2 decimal positions, the edit word must be 
specified as 

EDTWRD('bbbb$0.bb') 
where the b represents a blank. 
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Any printable character is valid, but the following characters in certain 
positions have special meanings: 
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- Blank: A blank is replaced with the character from the corresponding 
position of the data field. A blank position is referred to as a digit 
position. 

- Ampersand: An ampersand causes a blank in the edited field. The 
ampersand is not printed. 

- Zero: A zero stops zero suppression; place it in the rightmost position 
where zero suppression is to stop. The.zero is replaced with the 
character from the corresponding position of the data field, unless that 
character is a zero. Any zeros in the data that appear to the right of the 
stop-zero-suppression character are printed. At least one leading zero is 
suppressed. Each leading zero that is suppressed is replaced by a blank. 

- Asterisk: An asterisk stops zero suppression and replaces leading zeros 
with asterisks (asterisk protection). Place the asterisk in the rightmost 
position where zero suppression is to stop. Each zero that is suppressed 
is replaced by an asterisk. An asterisk preceding a zero is interpreted as 
representing asterisk protection; in this case, the zero prints as a 
constant. 

An asterisk is considered a digit-replace position. 

~ Currency Symbol: A currency symbol coded Immediately to the left of the 
zero suppression code causes the insertion of a currency symbol in the 
position to the left of the first significant digit. It is called the floating 
currency symbol when used in this manner. 

A currency symbol coded in the leftmost position of the edit word is 
fixed and prints In the same location each time. When used In this 
manner it Is called the fixed currency symbol. 

The currency symbol is not considered a digit replace position. This 
symbol must correspond to the system value QCURSYM. 

- Decimals and Commas: Decimals and commas are printed in the same 
relative positions in which they are coded in the edit word unless they are 
to the left of the first significant digit. In that case, they are blanked out 
or replaced by an asterisk. 

- All Other Characters: All other characters are printed if they are to the 
right of significant digits in the data field. If they are to the left of the 
high-order significant digits in the data word, they are blanked out or 
replaced by asterisks if asterisk protection is being used. 
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• Both EDTWRD and EDTCDE cannot be specified for the same field. 
Option indicators are not valid with this keyword. 

The following example shows how to specify the EDTWRD keyword: 


• If you want to show a negative sign with a negative number, include a sign 
in the edit word. Use either the minus sign (-) or the letters CR (credit). 
These print only if the number is negative. 
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Figure 5-4 shows sample edit words with the program value of the field and EDTWRD 

the printed value of the field. 



Figure 5-4. Sample Edit Words 
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INDTXT(indicator 'indicator-usage-text') 

Use this file, record, or field level keyword to associate descriptive text 
(indicating intent or usage) with a specific option indicator. You can specify it 
once for each indicator. 

If you specify this keyword, indicator usage text is a required parameter value. 
It must be a character literal and must be enclosed in apostrophes. If the 
length of the text is greater than 50 positions, only the first 50 characters are 
used by the high-level language compiler. 

Option indicators are not valid with this keyword. 

Note: This specification by itself does not cause the specified indicator to 
appear in the output record area. It merely provides text to be associated with 
the indicator. If the indicator has not been specified elsewhere (either as an 
option or a response indicator), then the text is lost without a diagnostic. Also, 
once an indicator has been given a textual assignment (either by this keyword 
or the response indicator text), no other textual assignment is made. 

The following example shows how to specify the INDTXT keyword: 
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Use this field level keyword to specify the location of an unnamed, four-digit, 
zoned decimal field to contain the page number. Specify only the PAGNBR 
keyword and the location of the field. (The location of the field can be either 
position only, or line number and position.) 

When the printer file is opened, CPF sets the page count to zero and 
Increments it by one before printing each new page whether or not the 
PAGNBR keyword is specified. The page number is printed each time any field 
for which the PAGNBR keyword is specified is printed. The page number is 
not incremented beyond 9999; it stays 9999 until it is reset. To reset the page 
count, condition PAGNBR with option indicators; CPF resets the page number 
when your program selects PAGNBR. See On Separate Lines with Separate 
Indicators later in this keyword description. 

You can optionally specify EDTCDE or EDTWRD with the PAGNBR keyword. 
Option indicators are valid with this keyword. 

The field (location only) and the keyword can be specified on one line with no 
indicators or on separate lines with separate indicators. The following sections 
explain the differences. 


On One Line with No Indicators: The page number Is always printed and you 
cannot reset It to one. 
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Two constant fields are specified: 
'PAGE:' and the page number Itself 
(location specified as +1). 
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PAGNBR On Separate Lines with Separate Indicators: If the field indicator {01 in the 

following example) is off, the field is not printed, no matter what the keyword 
indicator (02 in the following example) is set to. if the field indicator is on, the 
field is printed. The page count is incremented as long as the keyword 
indicator is not changed (the keyword indicator can be off or on and the page 
number is still printed). However, If the keyword indicator is changed from off 
to on, the page count is reset to one. 
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REF(data-base-file-name[.library-name][format-name]) 

Use this file level keyword to specify the name of a file from which field 
descriptions are to be retrieved. Use it when you want to duplicate descriptive 
information from one or more fields in a previously described record format. 
You can code the file name once here rather than on the REFFLD keyword 
with each of the field descriptions that reference the file. 

If there is more than one record format in the referenced file, specify a record 
format name as a parameter value for this keyword to tell CPF which one to 
use, unless the formats should be searched sequentially. 

The file name is required for this keyword; the record format name and the 
library name are optional. 

If you do not specify the library name, the current library list is used, if the 
record format name is not specified, each format is searched in order (as they 
are specified); the first occurrence of the field name Is used. For more 
information, see Appendix A, How to Specify REF and REFFLD. 

Option indicators are not valid with this keyword. 
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The following examples show how to specify the REF keyword 
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In this example, FLD1 has the same attributes as the first (or only) 
FLD1 in FILE1. 
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In this example, FLD1 has the same attributes as FLD1 in RECORD2 in 
FILE1 in LIB1. 














































REFFLD(referenced-field-name[.record-format-name] 


*SRC 

data-base-file-name [.library-name] 
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}) 


Use this field level keyword when referencing a field under one of these three 
conditions: 


• The name of the referenced field is different from the name in positions 19 
through 28. 

• The name of the referenced field is the same as the name in positions 19 
through 28, but the record format file, or library of the referenced field is 
different from that specified with the REF keyword. 

• The referenced field occurs in the same DOS source file as the referencing 
field. 


The referenced field name is required even if it is the same as the referencing 
field. Use the record format name when the referenced file contains more than 
one record format. Use *SRC to search the DOS source file in which the 
referencing field occurs (this is the default value when the data base file name 
and library name are not specified). Specify the data base file name (qualified 
by its library name, if necessary) when you want to search a particular data 
base file. 


If, in the same DOS source file, you specify REF at the file level and REFFLD 
at the field level, the REFFLD specification is used. The particular search 
sequence depends on both the REF and REFFLD keywords. For more 
information, see Appendix A, How to Specify REF and REFFLD. 

An R must be specified in position 29. 

Option indicators are not valid with this keyword. 
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REFFLD following example shows how to specify the REFFLD keyword. Because 

the REF keyword is not specified, the default for lines 00030 and 00040 is to 
search the DDS source file In which they are specified. In line 00080, the 
parameter value *SRC explicitly specifies the source file. See the example in 
Appendix A, How to Specify REF and REFFLD, for explanations of the 
specifications. 
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Use this file, record, or field level keyword to specify that the printer device is 
to skip to a specific line number after it prints one or more lines. The 
parameter value is required and must be in the range 1 through 255. 

If you specify the keyword at the file level, you must option it with one or 
more indicators; otherwise, option indicators are optional. The specified skip is 
performed after each record in the file has been printed. 

If you specify the keyword at the record level, skipping is performed after ail 
the lines associated with the record have been printed and before any file level 
SKIPA keywords have been applied. 

If you specify the keyword at the field level, skipping is performed after the 
field is printed. 

Note: If line numbers are not used and you do not specify skip or space 
keywords, overprinting can result. 

This keyword can be specified once at the file level, once at the record level, 
and once for each field. 

This keyword is valid at the file level for all records, but it is not valid at the 
record level or the field level for records that have line numbers specified 
(positions 39 through 41). (The line number entries are flagged as errors.) 

The following example shows how to specify the SKIPA keyword: 
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SKIPB(skip-before-line-number) 


Use this file, record, or field level keyword to specify that the printer device is 
to skip to a specific line number before it prints the next line(s). The parameter 
value is required and must be in the range 1 through 255. 

If you specify this keyword at the file level, you must option it with one or 
more indicators; otherwise, option indicators are optional. The specified skip is 
performed before each record in the file is printed and after applying any file 
level SKIPB operations. 

If you specify this keyword at the record level, skipping is performed before 
any of the lines associated with that record are printed. 

If you specify this keyword at the field level, skipping is performed before the 
field is printed. 

This keyword can be specified once at the file level, once at the record level, 
and once for each field. 

This keyword is valid at the file level for all records, but it is not valid at the 
record or field level for records that have line numbers specified (positions 39 
through 41). (The line numbers are flagged as errors.) 

Note; If line numbers are not used and you do not specify skip or space 
keywords, overprinting can result. 

The following example shows how to specify the SKIPB keyword: 
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Use this record or field level keyword to specify that the printer device is to 
space some number of lines after it prints one or more lines. The parameter 
value is required and must contain one of the following values: 

0 - No spacing 

1 - Space one line 

2 - Space two lines 

3 “ Space three lines 

If you specify this keyword at the record level, spacing occurs after all lines 
associated with that record have been printed. This keyword can be specified 
only once at the record level and once for each field. 

If you specify this keyword at the field level, spacing is performed after the 
field is printed. 

This keyword is not valid for records that have line numbers specified 
(positions 39 through 41). (The line numbers are flagged as errors.) 

Option indicators are valid with this keyword. 

Note: If line numbers are not used and you do not specify space or skip 
keywords, overprinting can result. 

The following example shows how to specify the SPACEA keyword: 
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SPACEB(space-before-value) 


Use this record or field level keyword to specify that the printer device is to 
space some number of lines before printing the next line or lines. The 
parameter value is required and must contain one of the following values: 


0 - No spacing 

1 - Space one line 

2 - Space two lines 

3 ~ Space three lines 

If you specify the keyword at the record level, spacing is performed before any 
lines associated with that record are printed. If you specify it at the field level, 
spacing is performed before the line containing that field is printed. This 
keyword can be specified only once at the record level or once for each field. 

This keyword is not valid for records that have line numbers specified 
(positions 39 through 41). (The line numbers are flagged as errors.) Option 
indicators are valid with this keyword. 

Note: If line numbers are not used and you do not specify space or skip 
keywords, overprinting can result. 

The following example shows how to specify the SPAGEB keyword: 
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TEXT{'description') 

Use this record or field level keyword to supply a text description (or comment) 
for the record format or field. This text is used for program documentation. If 
the length of the text is greater than 50 positions, only the first 50 characters 
are used by the high-level language compiler. 

The TEXT keyword is valid for any record format or named field. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the TEXT keyword: 


Printer Files 

TEXT 





Conditioning 

i 

17 1 

Name 

19 20 21 22 23 24 25 26 27 28 

ui Reference (R) 

Length 

30 31 32 33 34 

81 Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

ii 

II 

36 37 

z 

I 

$ 

p 

3e 

i 

38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

» Form Type 

1 

1 

1 

7 

Z 

i 

z 

k 

Condition Name 

1 

1 

9 10 

Z 

o 

z 

11 

1 Indicator 

z 

1 

14 

1 

1 

15 16 

Line 

39 40 41 

Pos 

42 43 44 

msm 

Q 











@1 

imiimi 











II 










a 



1 

1 







II 

lOritm 





:: M3 


Wfi 



■D 

il 

F13 

ii 









□ 






































D 



1 

■ 

































D 



1 

■ 


































D 



■ 

■ 

■ 

■ 

■ 

1 

■ 

1 

II 

11 

■m 

1 










HI 




1 











D 



1 

1 



















n 


HI 




1 











a 













j 



_ 

j 





J 


J 

HH 

HU 




1 












a 












■■ 

bh 

1 



1 

1 


1 



HU 

HI 




1 

m 











a 
























i 


HI 




1 

H 











a 
























:] 



- 











Printer Files 


5-37 





















Printer Files 
TIME 


TIME 


Use this field level keyword to specify that CPF is to retrieve the current 
system time and print it in a constant field. The time is retrieved when the 
printer file is opened and remains the same until the file is closed. The 
following information is implied: 

• A print length of 8 positions 

• The edit word 'Ob:bb:bb' (if no editing specified, this edit word is 
assumed) 

You can specify only the location of the field on the page. Positions 17 
through 38 must be blank. 

You can also specify a different edit word; for example, 
EDTWRD('ObHRS:bbMINS:bbSECS.') or one of the user-defined edit codes 
to be used in place of the Implied edit word (see EDTCDE and EDTWRD 
keywords). 

Option Indicators are not valid with this keyword. 


The following example shows how to specify the TIME keyword: 
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UNDERLINE 

Use this field level keyword to specify that CPF is to underline the field when It 
is printed. UNDERLINE can be specified only if the printer supports 
underlining. Option indicators are valid with this keyword. 


The following example shows how to specify the UNDERLINE keyword: 
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Chapter 6. Communications Files and BSC Files 


This chapter is divided into two sections. The first. Positional Entries, provides 
rules and examples for filling in positions 1 through 44 of the Data Description 
Specifications form. To find information in this section, first determine what 
position on the form to use, then look up the section describing that position. 

The second section of this chapter. Keyword Entries, provides rules and 
examples for specifying DDS keywords. The keywords are described in 
alphabetical order. 

Complete communications and BSC (Binary Synchronous Communications) file 
examples can be found in Appendix F, Examples. 

An explanation of file level, record level, and field level can be found in Chapter 
1, Introduction. 

The syntax rules for specifying DDS keywords can be found in Chapter 1, 
Introduction. 


For guidance in choosing positional entries and keywords for communications 
or BSC files, see the Data Communications Programmer's Guide. 

When you are describing a communications or a BSC file, you must specify the 
entries in the following order: 


1. File level entries (optional) 


2. Record level entries 

3. Field level entries 


) Repeat these entries for each 
record format in the file. 


You must specify at least one record format in the file and at least one field in 
the file. 


Note: The file name is specified through the Create Communications File 
(CRTCMNF) command or the Create BSC File (CRTBSCF) command, not 
through DDS. 

The maximum number of record formats in a communications or a BSC file is 
1024. The maximum number of fields in any one record format is 32 767 for 
communications files and 8192 for BSC files. For communication files, the 
maximum combined length of all fields and indicators in the buffer for one 
record format is 32 767. For BSC files, the maximum combined length of all 
fields in the buffer for one record format is 8192. 


Communications Files and BSC Files 



= T= International Business Machines Corporation 


DATA DESCRIPTION SPECIFICATIONS 


GX21-7754-1 UM/OSO* 
Printed in U.S,A. 


File 


Programmer 

1 Date 


Graphic 


r~ 





n 

Key 


[_ 





□ 


I i I i 


a, O Line 

fill 

ISlI 


4 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 66 66 67 6 


9 70 71 72 73 74 75 76 77 78 79 80 





Figure 6-1. Communications or BSC File Coding Example 






































Positional Entries (Positions 1-44) 

This section describes how to specify the first 44 positions of the Data 
Description Specifications form for communications and BSC files. To code the 
rest of the form, see the section Keyword Entries (Functions Field, Positions 
45-80) later in this chapter. 

Figure 6-1 shows some of the positional entries for communications files and 
BSC files. 


Communications 
and BSC Files 

Positions 1-5 


Positions 1-5 (Sequence Number) 

Use these positions to specify a sequence number for each line on the form. 
The sequence number is optional and is used for documentation purposes only. 


Position 6 (Form Type) 

The A in this position designates this as a Data Description Specifications 
form. The form type is optional and is for documentation purposes only. 


Position 7 (Comment) 

An asterisk (*) in position 7 identifies the line as a comment line. Comment 
lines can appear anywhere in the DDS and are retained only in the source file 
and printed on the source listing. Use positions 8 through 80 for comment 
text. A blank line (no characters specified in positions 7 through 80) is treated 
as a comment line. 
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Positions 7-16 


Positions 7-16 (Conditioning) 

Positions 7 through 16 are a multiple-field area in which you can specify 
option indicators. Option indicators are 2-digit numbers from 01 to 99. Your 
program can set option indicators on or off to select a keyword for output 
operations. Option indicators are not valid for fields in communications and BSC 
files. (Response indicators can be specified only as parameter values for the 
keywords INDTXT, RCVENDGRP, and TRNRND. Figure 6-1 shows how to 
specify option and response indicators.) 


A condition is an ANDed grouping of one to nine indicators that must all be in 
effect (set off if N is not specified; set on if N is specified) before the keyword 
is selected. 


A maximum of nine option indicators for each condition and nine conditions for 
each keyword is valid; therefore, a maximum of 81 indicators can be specified 
for each keyword, when nine indicators are used with nine conditions. 

When you specify a condition so that more than one indicator must be on or 
off before the condition is satisfied, it is called an AND condition; you are 
essentially saying that the first indicator you specified, AND the second, AND 
the third, and so on, must be ail in effect before the condition is satisfied and 
the keyword is selected. The keyword must be specifed on the same line as 
the last (or only) set of indicators specified. 

You can also specify several conditions for a keyword so that if any one of 
them is satisfied, the keyword is selected. This is called an OR relationship, 
and it means that if the first condition is satisfied, OR the second condition, 

OR the third condition, and so on, the keyword is to be selected. Note that 
conditions within the OR relationship can consist of just one indicator or can 
consist of several indicators ANDed together. Indicators can be ANDed to 
form a condition; conditions can be ORed to give your program several ways 
to select the keyword. 


AND (Position 7): If you need more than three indicators to form an ANDed 
condition, specify them on the next line or lines. You can specify A in 
position 7 on the second or following lines to designate the continuation of the 
ANDed condition; or you can leave it blank because A is the default. 
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Position 17 


OR (Position 7): If you specify several conditions that are to be ORed together, 
each condition must start on a new line and each condition except the first 
must have an O in position 7. An 0 specified for the first condition produces a 
warning message, and that position is assumed to be blank. 


NOT (Positions 8, 11, 14): If you want an indicator to be off instead of on to 
satisfy a condition, specify N in the position just preceding the indicator 
(position 8, 11, or 14). 


Conditioning More Than One Keyword: If you want to condition one or more 
keywords, specify the keywords on the same line. The last (or only) indicator 
must appear on the same line as the keywords. If the conditioning applies to 
keywords on more than one line, keyword continuation must be used for the 
indicators to apply to all keywords. See the Data Description Specifications 
Syntax Rules in Chapter 1, Introduction. 


Position 17 (Name Type) 

The value in this position identifies the type of name specified in positions 19 
through 28 (name). The valid entries for communications files and BSC files 
are: 


Entry Meaning 

R Record format name 
Blank Field name 

Figure 6-1 shows how to code the name type field. 


Position 18 (Reserved) 

This position does not apply to any file and must be blank unless an asterisk 
appears in position 7 (which indicates a comment line). 
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Positions 19-28 


Positions 19-28 (Name) 

Use these positions to specify record format names and field names. The 
following rules apply: 

• Names must be 10 characters or less. 

• Names must start in position 19. 

• Names must begin with an alphabetic character (A through Z, @, $, and #). 
All subsequent characters can be alphameric (A through Z, 0 through 9, 

$, #, and underscore [_]). There can be no embedded blanks. 

High-level languages can impose specific length and value restrictions on 
names. For example, RPG III accepts only field names of 6 characters or less 
and record format names of 8 characters or less, and they cannot contain an 
underscore. It is your responsibility to make sure that the names used here are 
acceptable to all language processors that process the file. 


Record Format Name: When you specify R in position 17 (name type), the 
name specified in positions 19 through 28 is a record format name. You can 
specify more than one record format for a communications file or BSC file, but 
each record format name must be unique within that file. You must specify 
field names to complete a record format in a communications file or a BSC file. 


Field Name: When you specify a blank in position 17 (name type), the name 
specified in positions 19 through 28 is a field name. Field names must be 
unique within the record format. For communications and BSC files, the order 
in which field names are specified in the DOS is the order the fields take in the 
input and output buffers (the input and output buffers are the same). 
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Position 29 (Reference) 

Specify R in this position to use the reference function of CPF to copy the 
attributes of a previously defined named field (called the referenced field) in the 
field you are defining now. The referenced field can be previously defined in 
the communications or the BSC file you are defining; or it can be in a 
previously created data base file (the data base file to be referenced is 
specified on the REF or REFFLD keywords). The field attributes referenced are 
the length, the data type, and the decimal positions of the field, as well as 
editing and text keywords. 

If you do not specify R, you cannot use the reference function for this field and 
you must specify field attributes for this field. 

Position 29 must be blank at the file and record levels. 

The name of the referenced field can be either the same as the field you are 
defining or different from the field you are defining. If it is the same, you need 
only specify R in position 29 (in addition to specifying the name of the field 
you are defining in positions 19 through 28). If it is different, you must specify 
the name of the referenced field with the REFFLD keyword. 

You can specify the name of the file defining the referenced field as a 
parameter value with the REF or the REFFLD keyword. See REF and REFFLD 
keyword descriptions later in this chapter and Appendix A, How to Specify REF 
and REFFLD, for explanations of how CPF finds the referenced field. 

You do not need to copy all attributes from a previously defined field to the 
field you are defining. To override specific attributes of the referenced field, 
specify those attributes for the field you are defining. For example, if you 
specify length for the field you are defining, the length is not copied from the 
referenced field. 

When you override data type to character (by specifying A in position 35), 
decimal positions are not copied from the referenced field. 

Note: Once the communications or the BSC file is created, the referenced file 
can be deleted or changed without affecting the field definitions in the 
communications or the BSC file. To Incorporate changes made in the 
referenced file, delete and re-create the communications or the BSC file. 
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Position 29 
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Positions 30-34 


Positions 30-34 (Length) 


You must specify a length for each named field unless the length is being 
duplicated from a referenced field. Specify the number of digits for a numeric 
field, or the number of characters for a character field. The length specification 
must be right-justified; leading zeros are optional. 

The following example shows valid and invalid length specifications: 
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Invalid Length Specification 
Valid Length Specification 


Valid length specifications are: 


Data Type 

Character 

Binary 

Zoned decimal 
Packed decimal 


Valid Length 

Communications Files BSC Files 

1 through 32 767 characters 1 through 8192 characters 

1 through 9 digits 1 through 9 digits 

1 through 31 digits 1 through 31 digits 

1 through 31 digits 1 through 31 digits 
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The sum of the number of bytes occupied by all fields in a record must not 
exceed 32 767 for communications files and 8192 for BSC files. The number 
of bytes actually occupied is determined by the system as follows: 


Data Type 


Bytes Occupied 


Character 

Binary 

1 -4 digits 
5-9 digits 
Zoned decimal 
Packed decimal 


Number of characters 

2 bytes 
4 bytes 

Number of digits 
(Number of digits/2) + 1 


Figure 6-1 shows how to code the field length. 


If you are using a referenced field, you can override the length of the field by 
specifying a new value or by specifying the increase or decrease in length. To 
increase the length, specify +n, where n is the increase. To decrease the 
length, specify -n, where n is the decrease. For example, an entry of +4 for a 
numeric field indicates that is to be 4 digits longer than the referenced field. 


Note: High-level languages can impose specific length and value restrictions 
on the field length; these restrictions should be observed for files used by 
those languages. 
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Positions 30-34 
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Position 35 


Position 35 (Data Type) 

Use this position to specify the data type of the field within the file. The valid 
data type entries for communications and BSC files are: 


Entry 


Meaning 


Numeric types 
P 
S 
B 


Packed decimal 
Zoned decimal 
Binary 


Alphabetic type 
A 


Character 


If you do not specify a data type and do not duplicate one from a referenced 
field, CPF assigns a default value as follows: 

• A (character) if the decimal positions (36 through 37) are blank 

• S (zoned decimal) if the decimal positions (36 through 37) contain a number 
in the range 0 through 31 

Note: Placing 0 in position 37 is a convenient way to specify an integer 
numeric field. 


Figure 6-1 shows how to code the data type. 



Positions 36-37 (Decimal Positions) 

Use these positions to specify the decimal placement within a packed decimal, 
a zoned decimal, or a binary field. Specify a decimal number from 0 through 
31 to indicate the number of decimal positions to the right of the decimal 
point. (This number must not be greater than the number of digits specified in 
the field length.) Figure 6-1 shows how to code the decimal positions field. 

If you are using a referenced field, these positions can be either overridden or 
changed. To override the positions, specify the new value. To change the 
positions, specify the amount you want the field increased or decreased and 
precede it with either a + or -, respectively. For example, an entry of +4 
indicates there are to be four more digits to the right of the decimal point than 
were in the referenced field. If the resulting number of decimal positions is 
greater than the maximum allowed, an error message is sent. 

Note: High-level languages can impose specific length and value restrictions 
on the decimal positions; these restrictions should be observed for files used 
by those languages. 


Position 38 (Usage) 

For communications files or BSC files, you can specify B (for both, or 
output/input fields); if left blank, the default is B. 


Positions 39-44 (Location) 

These positions do not apply for a communications or a BSC file and must be 
blank unless an asterisk appears in position 7. 
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Positions 36-37 
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and BSC Fiies Keyword Entries, (Positions 45-80) 

Keyword Entries 

This section contains keyword entries valid for defining communications files 
and BSC files. They are entered in positions 45 through 80 (functions). See 
Data Description Specifications Syntax Ruies in Chapter 1 for a discussion of the 
general rules for specifying keywords. Figure 6-2 shows how to use the 
general rules to specify DOS for a communications file or BSC file. 
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You can specify option indicators 
in the boxed-in positions. 


Figure 6-2. Syntax for a Communications File or BSC File 

















In this section, keywords are described in alphabetical order, and each is 
illustrated with an example. 
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and BSC Files 

ALWWRT 


The following keywords are valid for communications files and BSC files: 

ALWWRT 

ENDGRP 

FAIL 

INDTXT 

RCVENDGRP 

REF 

REFFLD 

RQSWRT 

RTGDEV 

RTGDEVCLS 

RTGFMT 

RTGPOS 

TEXT 

TRNRND 


ALWWRT 

Use this file or record level keyword (allow write) so that your program can 
indicate that it has finished sending. The ALWWRT keyword is valid only on 
an output operation when your program is in the send state. 

Option indicators are valid with this keyword. (When you specify this keyword 
at the file level, you should specify an option indicator.) 


SNA Considerations: CPF sends an end chain (EC bit) and a change direction 
indication (CD bit). Your program goes to the receive state. 


BSC Considerations: CPF sends an end of transmission (EOT). Your program 
goes to the contention state. 

The following example shows how to specify the ALWWRT keyword: 
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ENDGRP 


ENDGRP 

Use this file or record level keyword (end of group) so that your program can 
indicate the end of a user-defined group of records. The ENDGRP keyword is 
valid only on an output operation when your program is in the send state. 
(Your program remains in the send state.) 


Option indicators are valid with this keyword. (When you specify this keyword 
at the file level, you should specify an option indicator.) 


SNA Considerations: CPF sends an end chain (EC bit). 


BSC Considerations: CPF sends a null record (STXETX). When your program 
transmits user-blocked data (parameter BLOCK(*USER) specified on the Create 
BSC File (CRTBSCF), the Change BSC File (CHGBSCF), or the Override BSC 
File (OVRBSCF) command), the ENDGRP and RCVENDGRP keywords have no 
effect. 

The following example shows how to specify the ENDGRP keyword: 
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00 Reserved 

Name 
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1 

cc 

29 

Length 

30 31 32 33 34 

^ Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

i| 

II 
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S Usage (B/O/l/B/H/M) 

Location 

45 46 47 

Functions 
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Sequence 
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FAIL 

Use this file or record level keyword so that your program can terminate a 
session when it can no longer continue because of some problem. All records 
not already sent in the current transmission are discarded, and no further 
records are sent. The FAIL keyword is valid only on an output operation; your 
program can issue an output operation with the FAIL keyword selected when it 
is in either the receive or the send state. 

If the FAIL keyword is in effect the keywords ALWWRT, ENDGRP, and 
RQSWRT are ignored. 

Option indicators are valid with this keyword. (When you specify this keyword 
at the file level, you should specify an option indicator.) 


SNA Considerations: In the receive state, when your program issues an output 
operation with the FAIL keyword in effect, an SNA negative response (-RSP) is 
transmitted. 

In the send state, when your program issues an output operation with the FAIL 
keyword in effect, an SNA CANCEL is transmitted. 


BSC Considerations: In the receive state, when your program issues an output 
operation with the FAIL keyword in effect, an abort, which is an end of 
transmission (EOT), is transmitted instead of the normal acknowledgment 
(ACKO or ACK1). 

In the send state, when your program issues an output operation with the FAIL 
keyword in effect, a forward abort sequence (STXENQ followed by an EOT) is 
transmitted. 

The following example shows how to specify the FAIL keyword: 






Conditioning 

1 

K 

> 

1 

2 

17 

es Reserved I 

Name 

19 20 21 22 23 24 25 26 27 28j 

S Reference (R) 

Length 

30 31 32 33 34 

g; Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

Decimal 

Positions 

g Usage (b/O/l/B/H/M) 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

® Form Type 

And/Or/Comment (A/0/*) 
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9 10 
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Line 

39 40 41 
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42 43 44 
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IN DTXT(response-or-option-indicator 'indicator-usage-text') 

Use this file or record level keyword to associate descriptive text (indicating 
intent or usage) with a specific response or option indicator. You can specify it 
once for each response and option indicator. 


If you specify this keyword, indicator usage text is a required parameter value 
and must be a character literal enclosed in apostrophes. If the length of the 
literal is greater than 50 positions, only the first 50 characters are used by the 
high-level language compiler. The text is used during compilation to aid 
program documentation. 


Option indicators are not valid with this keyword. 


Note: The INDTXT keyword does not cause the specified indicator to appear 
in either the input or the output record area. It provides text to be associated 
with the indicator. Once an indicator has been given a textual assignment 
(either by this keyword or by the response indicator text), no other textual 
assignment is made. A message is issued and the keyword is ignored. This 
differs from other keywords that can have indicators specified as parameter 
values, in that, for other keywords, the text is ignored. 

The following example shows how to specify the INDTXT keyword: 
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I 
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Z 0 

17 11 
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w Reference (R) 

Length 
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li! Indicator 

n 

z 

1 

14 

- Indicator 

Line 

39 40 41 

Pos 

42 43 44 




A 












T 


























0^0 04 

o 

A 











g. 


P 

1 






















0 

DOS 

id 

A 


































r«OTXTO0 VRecei yea s«+' ) 






A 








































A 


























“1 














A 





































6-16 


f 





RCVENDGRP(response-mdicator ['text']) 

Use this file or record level keyword (receive end of group) so that CPF can set 
on the specified response indicator to inform your program of the end of a 
user-defined group of records. The RCVENDGRP keyword is valid only on an 
input operation when your program is in the receive state. (Your program 
remains in the receive state.) 

The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 

Option indicators are not valid for this keyword. 
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RCVENDGRP 


SNA Considerations: The response indicator is set on when CPF detects an end 
chain (EC bit). 


BSC Considerations: The response indicator is set on when CPF detects a null 
record (STXETX). When receiving user-blocked data (parameter 
BLOCK(*USER) specified on the Create BSC File (CRTBSCF), the Change BSC 
File (CHGBSCF), or the Override BSC File (OVRBSCF) command), the 
RCVENDGRP keyword has no effect. 

The following example shows how to specify the RCVENDGRP keyword: 






Conditioning 

:i Name Type (B/R/K/S/0) I 

00 Reserved | 

Name 

19 20 21 22 23 24 25 26 27 28 

<0 Reference (R) 

Length 

30 31 32 33 34 

S Data Type (b A/P/S/B A/S/X/Y/N/l/W) 
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Number 

12 3 4 

5 

® Form Type 

^ And/Or/Comment <A/0/*) 
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REF(data-base-file-nanne[.library-name}[record-format-name]) 

Use this file level keyword to specify the name of a file from which field 
descriptions are to be retrieved. Use it when you want to duplicate descriptive 
information from several fields in a previously described record format. You 
can code the file name once rather than on REFFLD keywords with each of the 
field descriptions that reference the file. To reference more than one file, use 
the REFFLD keyword. (The REF keyword can be specified only once.) 

If there is more than one record format in the referenced file, specify a record 
format name as a parameter value for this keyword to tell CPF which one to 
use unless the record formats should be searched sequentially. 

The file name is a required parameter value for this keyword; the library name 
and the record format name are optional. 

If you do not specify the library name, the current library list is used. If the 
record format name is not specified, each format is searched in order (as they 
are specified); the first occurrence of the field name is used. For more 
information, see Appendix A, How to Specify REF and REFFLD. 

Option indicators are not valid with this keyword. 


r 



The following examples show how to specify the REF keyword 
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Conditioning 

^ Name Type (IVR/K/S/O) 

Name 

19 20 21 22 23 24 25 26 27 28 

Reference (R) | 

Length 

30 31 32 33 34 

1 

z 

> 

X 

1 

00 
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1 

35 

ii Decimal 

ij Positions 

n 
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38 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 66 66 67 68 66 70 71 72 73 74 7576 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 

1 * Form Type 
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Condition Name 
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In this example, FLD1 has the same attributes as the first (or 
only) FLD1 in FILEI. 



““ 








D 







L 


L 

_ 











Sequence 

Number 


1 2 3 4 5 


Condition Name 


i 20 21 22 23 24 25 26 27 28 


29 bo 31 32 33 34 


ill 


42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 


gEFCFTLEl.LIBi REtORfTT 


KM 


Fldi 



In this example, FLD1 has the same attributes as FLD1 in 
RECORD2 in FILE1 in LIB1. 
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REFFLD(referenced-field-name[.recqrd-format-name] 


i*SRC V \ 

ildata-base-file-name [.library-name]; ' 


Use this field level keyword when referencing a field under one of these three 
conditions: 


• The name of the referenced field Is different from the name in positions 19 
through 28. 

• The name of the referenced field is the same as the name in positions 19 
through 28, but the record format file, or library of the referenced field is 
different from that specified with the REF keyword. 

• The referenced field occurs In the same DOS source file as the referencing 
field. 

The referenced field name is required even if it is the same as the referencing 
field. Use the record format name when the referenced file contains more than 
one record format. Use *SRC to search the DOS source file in which the 
referencing field occurs (this is the default value when the data base file name 
and the library name are not specified). Specify the data base file name 
(qualified by its library name if necessary) when you want to search a particular 
data base file. 

If, in the same DOS source file, you specify REF at the file level and REFFLD 
at the field level, the REFFLD specification is used. The particular search 
sequence depends on both the REF and REFLD keywords. For more 
information, see Appendix A, How to Specify REF and REFFLD. 

An R must be specified in position 29. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the REFFLD keyword. Because 
the REF keyword is not specified, the default for lines 0(X)30 and OCXHO is to 
search the DDS source file in which they are specified. In line CX)080, the 
parameter value *SRC explicitly specifies the source file. See the example in 
Appendix A, How to Specify REF and REFFLD, for explanations of the 
specifications. 
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18 19 20 21 22 23 24 25 26 27 28 
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Length 

30 31 32 33 34 
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p 
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Location 

Functions 
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Number 
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RQSWRT 
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Use this file or record level keyword (request write) so that your program can 
request permission to send data. The RQSWRT keyword is valid only on an 
output operation when your program is in the receive state. 

If the RQSWRT keyword is in effect and the FAIL keyword is not in effect, the 
ALWWRT and ENDGRP keywords are ignored. 

Option indicators are valid with this keyword. (When you specify this keyword 
at the file level, you should specify an option indicator.) 


SNA Considerations: CPF sends a SIGNAL command. 


BSC Considerations: CPF sends a reverse interrupt (RVI). 

The following example shows how to specify the RQSWRT keyword: 




Conditioning 

:3 Name Type (B/R/K/S/0) I 

CO Reserved 

Name 

19 20 21 22 23 24 25 26 27 28 

(0 Reference |R) 

Length 

30 31 32 33 34 

^ Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

^ Decimal 

53 Positions 

g Usage (b/O/l/B/H/M) 

Location 

_ 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 6666 67 68 69 70 71 72 73 74 76 76 77 78 79 80 

Sequence 

Number 

1 2 3 4 5 I 

Form Type 

And/Or/Comment (A/0/*) 
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1 

9 10 
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Use of Routing Keywords 

You can use the routing keywords (RTG prefix) to cause CPF to place specific 
information regarding input operations (up to 80 characters) In the routing 
identification (RTG) field in the I/O feedback area. No information is entered 
for an output-only operation. 

CPF places the information into the routing field only after other specified 
functions have been performed successfully. 

Option indicators are not valid for routing keywords. 

Each routing keyword requires that you specify a routing field location, which is 
the first character position for that item in the routing field within the I/O 
feedback area. All entries must fit completely within the SO^byte routing area, 
and no checking is done to prevent overlapping entries in the routing area. If 
entries do overlap, the results can be predicted, based on the processing order 
of the keywords. Entries that are processed later overlay entries that are 
processed earlier. 

Note: Multiple specifications are not checked for overlap in the I/O feedback 
area. 

The processing order follows: 

RTGDEVCLS 

RTGDEV 

RTGFMT 

RTGPOS 

Figure 6-3 shows how to specify the routing keywords for communications 
files and BSC files. 
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Figure 6-3. Routing Keywords Coding Example 
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RTGDEV(starting-routing-field-iocation) 

This record level keyword causes CPF to place the 10-character device name 
into the routing field. Valid locations you can specify are within the range of 1 
through 71. 


RTGDEVCLS(starting-routing-field-location) 

Use this record level keyword to cause CPF to place the 2-character device 
class indicator into the routing field. Valid locations you can specify are within 
the range of 1 through 79. 

The class value that is placed in the routing field is hex 0609 for 
communications fiies and hex 070A for BSC files. 


RTGFMT(8tarting-routing-field-location) 

Use this record level Keyword to cause CPF to place the record format name 
(as determined by CPF for the input operation) into the routing field. The 
length of this entry in the routing field is always 10 bytes. 

Valid field locations you can specify are in the range of 1 through 71. 


RTGPOS(starting-routing-field-location starting-data-position 
ending-data-position) 

Use this record level keyword to identify character positions (within the data 
received from the host system) that are to be placed into the routing field. The 
positions are specified by supplying the starting position (relative to the 
beginning of the data stream) and ending position. 

Valid field locations you can specify are within the range 1 through 80, 
depending on the starting and ending data locations. 
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TEXT('de8cription') 

The text information is useful in high-level language user program record and 
field documentation produced by compiler output. Use this record or field level 
keyword to supply a text description of the current field or record format. If 
the length of the text is greater than 50 positions, only the first 50 characters 
are used by the high-level language compiler. The text must be enclosed in 
apostrophes. 

Option indicators are not valid with this keyword. 

The following example shows how to specify the TEXT keyword: 
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Conditioning 

1 
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TR N RN D(response-indicator ['text']) 

Use this file or record level keyword (turn around transmission) so that CPF can 
set on the specified response indicator to inform your program that the sending 
program or device has stopped sending. The TRNRND keyword is valid only 
on an input operation when your program is in the receive state. 


The optional text is included on the listing generated at program compilation 
time to explain the intended use of the indicator. This text has no function in 
the file or the program other than as a comment. The apostrophes are 
required. If you specify more than 50 characters between the apostrophes, the 
text is truncated to 50 characters on the program listing. 


Option indicators are not valid with this keyword. 


SNA Considerations: The response indicator is set on when CPF detects an end 
bracket (EB bit) or change direction (CD bit). 


BSC Considerations: The response indicator is set on when CPF detects a 
normal end of transmission (EOT). 

The following example shows how to specify the TRNRND keyword: 
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Appendix A. How to Specify REF and REFFLD 


This appendix should help you decide whether to specify REF or REFFLD or 
both, and how to specify parameter values for each REF or REFFLD keyword 
you specify. Note that you must specify R in position 29 for each referencing 
field. 

1. REF or REFFLD or both? 

If all or most of the referenced fields are defined in a single file other 
than the one you are now defining, specify REF at the file level. This 
should provide referencing for all or most of the referencing fields. (Note 
that the file you reference must be a data base file.) 

Specify REFFLD for every referencing field: 

• Not in the file specified on the REF keyword 


or 


• Whose name differs from the name of the field it references (this 
includes fields that reference fields in the file you are defining) 

2. For each REFFLD keyword specified, do you need a data base file name? 

If the REF keyword is specified, any data base file name specified on the 

REFFLD keyword overrides the data base file name on the REF keyword. 

On the REFFLD keyword, you can specify: 

• *SRC so that CPF searches the file you are defining for the referenced 
field 

• The data base file name that CPF is to search for the referenced field 

If the REF keyword is not specified, you can specify: 

• *SRC so that CPF searches the file you are defining for the referenced 
field (this is the default) 

• The data base file name for CPF to search for the field 
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3. For each data base file name specified, do you need a library name? 

If the job that creates the file you are defining (perhaps, your interactive 
job) has a library list, and the specified data base file is on the library list, 
specify only the file name (FILED. Otherwise, specify the file name 
qualified by the library name (FILEI.LIBD. 

4. For each REF or REFFLD keyword specified, do you need a record format 
name? 

If the referenced file has only one record format, do not specify a record 
format name. 

If the referenced file has more than one record format, specify a record 
format name. 

5. Repeat steps 2 through 4 for each REF or REFFLD keyword you specify. 



You can also specify library 
name and record format name. 
See the REF keyword example. 
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Figure A-1. Sample Reference Function Specifications 
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The following numbered items refer to Figure A-1: 

m FIELD1 and FIELD2 have the same attributes as FIELD1 and FIELD2 in 
FILEl. 

Q FIELDS has the same attributes as FLD3 in FILEl. 

B FIELD4 has the same attributes as FLD4 In FILE2 (different field name 
and different file from Q). 

Q FIELDS has the same attributes as FLD5 in FILES in LIB1. 

m FIELDS has the same attributes as FLD6 in record format RECORDB in 
FILE4inLIB1. 

Q FIELD? has the same attributes as FIELDS (on the preceding line in this 
file). 

Q FIELDS has the same attributes as FLDS in FILEl. 

Q FIELD1 in RECORDS has unique field attributes (it does not use the 
reference function; R is not specified in position 29). 

Q FIELD1 in RECORDS has the same attributes as FIELD1 in RECORDS. 

IQ FIELD1 in RECORD4 has the same attributes as FIELD1 in RECORD1. 



Appendix B. Physical and Logical File Keyword Summary 


Keyword 

Values 

Function 

Lever 

Groups^ 

ABSVAL 


The sign of the field is ignored when 
sequencing values (use absolute 
values). 

L/P-KFLD 

PTH 

ACCPTH 

(data - base-f ile- name 
[.library-name]) 

The keyed access path of a previously 
created logical or physical file is 
shared. 

L-FL 

PTH 

ALL 


The system selects or omits all 
records not meeting the select/omit 
rules. 

L-S/O FLD 

s/o 

ALTSEQ 

(alternate-sequence- 
table-name 
[.library-name]) 

An alternate collating sequence is 
used for the key. 

L/P-FL 

PTH 

CHECK 

(AB, ME, MF, M10, Mil, 
VN) 

A field value must meet one or more 
of the following check algorithms to 
be valid: 

• Allow blank (AB) 

• Mandatory enter (ME) or fill (MF) 

• Valid name (VN) 

• IBM Modulus 10 (M10) or 

11 (Mil) self-check 

CHECK does not request any action 
by data base data management, but 
can be specified in the data base file 
so that it can be duplicated into the 
display file when the field is 
referenced at display file creation. 

L/P-FLD 

CHK 

'Level: 

L-Logical file 

P-Physical file 

FL—File level 

RCD-Record level 

FLD-Field level 

KFLD-Key field level 

S/0 FLD-Select/omit field level 

^Groups: 

CHK-Validity checking keywords 

EDT~Editing and field setting keywords 

PTH-Access path keywords 

REF-Naming and referencing keywords 

S/0~Select/omit keywords 

TXT-Text definition keywords 
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PHYSICAL AND LOGICAL FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

LeveP 

Groups^ 

CMP 


See COMP (the preferred spelling). 



COLHDG 

{'line-1' [line-2' 
l'line-3']]) 

This specifies a column heading for a 
field (used by auery, DFU. and SDA). 

L/P-FLD 

TXT 

COMP 

(EQ. GE. GT, LE, LT, NE, 
NG, NL) 

A field value must meet a comparision 
or relation such as equal to, to be 
valid or selected. COMP is also used 
as a validity checking keyword, 
specified for retention in the data 
base file so that it can be duplicated 
into a display file through the 
reference function. 

L/P-FLD 
L-S/0 FLD 

CHK 

S/0 

CONCAT 

(field-1 field-2 
[maximum]) 

Fields from a physical file are 
concatenated into a field in a logical 
file. 

L-FLD 

REF 

DESCEND 


Values in a key field are retrieved in 
descending sequence. 

L/P-KFLD 

PTH 

DIGIT 


Only the digit portion (low-order 4 
bits) of each byte of the key field is 
used to build a key value. 

L/P-KFLD 

PTH 

EDTCDE 

(code [*lfloating- 
currency-symbol ]) 

This names the edit code by which 
field values are to be displayed. 
EDTCDE does not request any action 
by data base data management, but 
can be specified in the data base file 
description so that it can be 
duplicated into the display or printer 
file when this field is referenced at 
device file creation. 

L/P-FLD 

EDT 

^ Level: 

L-Logical file 

P-Physical file 

FL-File level 

RCD-Record level 

FLD-Field level 

KFLD-Key field level 

S/0 FLD-Select/omit field level 

^Groups: 

CHK-Validity checking keywords 

EDT-Editing and field setting keywords 

PTH-Access path keywords 

REF-Naming and referencing keywords 

S/O-Select/omit keywords 

TXT-Text definition keywords 
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PHYSICAL AND LOGICAL FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

Lever 

Groups^ 

EDTWRD 

('word') 

This specifies an edit word that 
describes the form in which field 
values are to be displayed. EDTWRD 
does not request any action by data 
base data management but can be 
specified in the data base file 
description so that it can be 
duplicated into the display or printer 
file when this field is referenced at 
display or printer file creation. 

L/P-FLD 

EDT 

FORMAT 

(data-base-file-name 

[.library-name]) 

A previously described record format 
is to be used. 

L/P-RCD 

REF 

LIFO 


Records with duplicate key values are 
processed in a last-ln-first-out (LIFO) 
order. 

L/P-FL 

PTH 

NOALTSEQ 


The alternate collating sequence is not 
to be used for the key field. 

L/P-KFLD 

PTH 

PFILE 

(data-base-file-name 
[.library-name] [.32.]) 

This names the physical file(s) on 
which the logical file and logical 
record format is to be based. 

L-RCD 

REF 

RANGE 

(low high) 

The field value must be within the 
specified range. RANGE is also used 
as a validity checking keyword, 
specified for retention in the data 
base file so it can be duplicated into a 
device file description through the 
reference function. 

L/P-FLD 
L-S/0 FLD 

CHK 

S/0 

REF 

(data - base-file- name 
[.library-name] 

[format-name]) 

The system refers to the data base 
file for field specifications. 

P-FL 

REF 

^ Level: 

L~Logicai file 

P-Physical file 

FL-File level 

RCD-Record level 

FLD-Field level 

KFLD-Key field level 

S/0 FLD-Select/omit field level 

^Groups: 

CHK-Validity checking keywords 

EDT-Editing and field setting keywords 

PTH-Access path keywords 

REF—Naming and referencing keywords 

S/0-Select/omit keywords 

TXT-Text definition keywords 
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PHYSICAL AND LOGICAL FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

Level' 

Groups^ 

REFFLD 

(ref erenced -field - name 
[ .record-format-name ] 
|*SRC 

\jata-base-flle-name 
[.library-name]/) 

The system refers to a field in a data 
base file for field specifications. 
Overrides REF keyword for this field. 

P-FLD 

REF 

RENAME 

(field-name) 

This renames a physical file fiejd 
name for a logical file record format. 

L-FLD 

REF 

SIGNED 


The sign of a field is considered when 
sequencing values. 

L/P-KFLD 

PTH 

TEXT 

('description') 

This specifies a text description of a 
new record format or field in a new 
record format. 

L/P-FLD 

L/P-RCD 

TXT 

TXT 

UNIQUE 


Key values must be unique. (No 
duplicate key values allowed.) 

L/P-FL 

PTH 

VALUES 

(value-1 [value-2... 
[value-20]]) 

The field value must be one of the 
values specified. VALUES is also 
used as a validity checking keyword, 
specified for retention in the data 
base file so that it can be duplicated 
into a display file through the 
reference function. 

L/P-FLD 
L-S/0 FLD 

CHK 

S/0 

ZONE 


Only the zone portion (high-order 4 
bits) of each byte of the key field is 
used to build a key value. 

L/P-KFLD 

PTH 

'Level: 

L-Logicai file 

P-Physical file 

FL-File level 

RCD~Record level 

FLD-Field level 

KFLD-Key field level 

S/0 FLO-Select/omit field-level 

^Groups: 

CHK-Validity checking keywords 

EDT~Editing and field setting keywords 

PTH-Access path keywords 

REF-Naming and referencing keywords 

S/O-Select/omit keywords 

TXT-Text definition keywords 
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PHYSICAL AND LOGICAL FILE KEYWORDS-GROUP LISTING 


Access path definition keywords (PTH) 

ABSVAL 

ACCPTH 

ALTSEQ 

DESCEND 

DIGIT 

LIFO 

NOALTSEQ 

SIGNED 

UNIQUE 

ZONE 


Editing and field setting keywords (EDT) 

EDTCDE 

EDTWRD 


Naming and referencing keywords (REF) 

CONCAT 

FORMAT 

PFILE 

REF 

REFFLD 

RENAME 


Select/omit keywords (S/0) 

ALL 

CMP 

COMP 

RANGE 

VALUES 


Text definition keywords (TXT) 

COLHDG 

TEXT 


Validity checking keywords (CHK) 

CHECK 

CMP 

COMP 

RANGE 

VALUES 
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PHYSICAL AND LOGICAL FILE KEYWOBDS-LISTED BY LEVEL 


Physical Files 

Logical Files 

File Level 

File Level 

■■■■■ 

ACCPTH 

ALTSEQ 

ALTSEQ 

UFO 

LIFO 

REF 

■■■■■ 

UNIQUE 

UNIQUE 

Record Level 

Record Level 

FORMAT 

FORMAT 

■■■■ 

PFILE (required for logical files) 

TEXT 

TEXT 

Field Level 

Field Level 

CHECK(AB; ME; MF; MiO; M11; VN) 

CHECK(AB; ME; MF; M10; Mil; VN) 

CMP 

CMP 

COLHDG 

COLHDG 

COMP j 

COMP 

■■■■i 

CONCAT 

EDTCDE 

EDTCDE 

EDTWRD 

EDTWRD 

RANGE 

RANGE 

REFFLD 

RENAME 

TEXT 

TEXT 

VALUES 

VALUES 

Key Field Level 

Key Field Level 

ABSVAL 

ABSVAL 

DESCEND 

DESCEND 

DIGIT 

DIGIT 

NOALTSEQ 

NOALTSEQ 

SIGNED 

SIGNED 

ZONE 

ZONE 

Select/Omit Level 

ALL 

CMP 

I 

COMP 

RANGE 


VALUES 



Appendix C. Display File Keyworcf Summary 






Option 


Keyword 

Values 

Function 

Level' 

Indicators^ 


ALARM 


An audible alarm is set on when 
the record is displayed. 

RCD 

0 

DSP 

ASSUME 


The system assumes that the 
record is currently on the display 
when the file is opened. 

RCD 



AUTO 


RA: See CHECK(ER) 

RAB: See CHECK(RB) 

RAZ: See CHECK(RZ) 



■ 

BLANKS 

(response- indicator 

The response indicator is set on 



mm 


['text']) 

when a field containing all blanks is 
received from the device. 

■■ 


m 

BUNK 


When the record is displayed, the 
cursor blinks. 

RCD 

0 

DSP 

BLKFOLD 


CPF folds the field at the last blank 
before the end of the line instead 
of at the actual end of the line. 

FLD 



CAnn 

[ (response-indicator 

The command key specified by nn 

FL 

0 

KBD 


['text'])] 

is a command attention key. 

RCD 

0 

KBD 

CFnn 

[ (response-indicator 

The command key specified by nn 

FL 

0 

KBD 


['text'])] 

is a command function key. 

RCD 

0 

KBD 

CHANGE 

(response-indicator 

The response indicator is set on 

RCD 




['text']) 

when data is changed in the field 
or in the record. 

FLD 


■■ 

CHECK 

(AB) 

Allows blank input data to satisfy 

FL 





validity checking requirements for 

RCD 





the field. 

FLD 



'Level: 


^Groups: 




FL-File level 


CHK-Validity checking keywords 




RCD-Record level 

CTL-Processing control keywords 




FLD-Field level 


DSP-Display control keywords 






EDT-Data editing/field setting keywords 



^Option Indicators: 

KBD-Keyboard control keywords 




O-Optional 


MSC-Miscellaneous keywords 




R-Required 


MSG-Message handling keywords 




Blank-Invalid 


REF-Naming and referencing keywords 





RTG-Routing keywords 






SFL(C)-Subfile control record keywords 





SFL(R)-Subfile record keywords 
TXT-Text definition keywords 
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DISPLAY FILE KEYWORDS (continued) 






Option 


Keyword 

Values 

Function 

UveP 

Indicators^ 

Groups^ 

CHECK 

(ER, FE, LC, 

On the 5250 work station, the 

FLD 


KBD 


RB, RZ) 

following controls are placed on 
input keying: 

• End of record (ER) 

• Field exit check (FE) 

• Lowercase (LC) 

• Right-adjust, blank fill (RB) 

• Right-adjust, zero-fill (RZ) 




CHECK 

(ME, MF, M10, Mil, VN) 

A field value must meet one or 
more of the following check 
algorithms to be valid: 

• Mandatory enter (ME) or fill 
(MF) 

• Valid name (VN) 

• IBM modulus 10 (M10) or 11 

FLD 

(See note 1.) 

CHK 



(Mil) self-check 




CHECK 

(RL) 

The cursor moves from right to left 



DSP 



within a field. 



DSP 






DSP 

CHECK 

(RLTB) 

The cursor advances between 
input-capable fields in a 
right-to-left, top-to-bottom 

FL 


DSP 



manner. 




CHGINPDFT 


The input-capable field is not to be 

FL 


DSP 



underlined. 

RCD 


DSP 




FLD 


DSP 

CLEAR 

[ (response-indicator 

Your program receives control 

FL 

0 

KBD 


['text*])] 

when the Clear key is pressed. 

RCD 

0 

(See note 2.) 

KBD 

CMP 


See COMP, (the preferred spelling). 




COMP 

(Ea NE, LT, NL. GT, NG, 

A field value must meet the 

FLD 


CHK 


LE, GE) 

specified comparison test such as 
equal to to be valid. 





'Level: 

^Groups: 

FL-File level 

CHK-Validity checking keywords 

RCD-Record level 

CTL-Processing control keywords 

FLD-Field level 

DSP-Display control keywords 

EDT-Data editing/field setting keywords 

^Option Indicators: 

KBD-Keyboard control keywords 

O-Optional 

MSC-Miscellaneous keywords 

R-Required 

MSG-Message handling keywords 

Blank-Invalid 

REF-Naming and referencing keywords 

RTG-Routing keywords 

SFL(C)-Subfile control record keywords 

SFL(R)-Subfile record keywords 

TXT-Text definition keywords 

Notes: 


1. Option indicators are valid for mandatory enter only. 

2. A response indicator must be specified for this keyword to be used by RPG. 












































DISPLAY FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

Level^ 

Option 

Indicators^ 

Groups^ 

CSRLOC 

(field-name-1 
fleld-name-2) 

Your program determines the 
cursor location by setting the 
contents of field-name-1 and 
field-name-2. 

RCD 

0 

DSP 

DATE 


The job date is displayed in the 
specified location. 

FLD 


EDT 

DFT 

('literal') 1'literal' 

The field is initialized to the literal 
value. (This keyword is also used 
to define constant fields.) 

FLD 


EDT 

DLTCHK 


The field validity checking 
keywords are ignored (deleted) 
when referencing field 
specifications from a data base file. 

FLD 


REF 

DLTEDT 


The edit information is ignored 
(deleted) when referencing field 
specifications from a data base file. 

FLD 


REF 

DSPATR 

(attribute [ attribute 
[attribute[...] ] ]) 

The following are display attributes 
for fields: 

• Column separator (CS) 

• High intensity (HI) 

• Underline (UL) 

. Blink field (BL) 

• Reverse image (Rl) 

• Protect (PR) 

• Set modified data tag (MDT) 

• Nondisplay (ND) 

• Select by light pen (SP) 

• Position cursor (PC) 

• Operator identification (OID) 

FLD 

(See note.) 

DSP 

^ Level: 

FL-File level 

RCD”Record level 

FLD-Field level 

^Option Indicators: 

O-Optional 

R-Required 

Blank-Invalid 

^Groups: 

CHK-Validity checking keywords 

CTL-Processing control keywords 

DSP-Display control keywords 

EDT-Data editing/field setting keywords 

KBD-Keyboard control keywords 

MSC-Miscellaneous keywords 

MSG-Message handling keywords 

REF-Naming and referencing keywords 

RTG-Routing keywords 

SFL(C)-Subfile control record keywords 

SFL(R)-Subfile record keywords 

TXT-Text definition keywords 

Note: Option indicators not used for select by light pen or operator identification. 
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DISPLAY FILE KEYWORDS (continued) 


Keyword 



EDTCDE 


EDTWRD 



ERASEINP 


ERRMSG 


ERRMSGID 


GETRETAIN 


Values 


(*DSx [*DSy [*DS 2 ]]) 
-or- 

l(lines chars 
![ condition-name-1 ] 
Klines chars 
[condition-name-2 ] 
|(lines chars 

[condition-name-3] ] ]) 


i (response-indicator 
['text'!)] 


(edit-check-code 
[ * I floating- 
cu rrency- symbol]) 


('edit-word') 


(record - name-1 
[record-name-2... 
record-name*20] ]) 



('message' [response- 
indicator]) 


(msgid msg-file 
[.library-name]) 



[ (response-indicator 
'text']) 


^ Level: 

FL-File level 
RCD-Record level 
FLD-Field level 

^Option Indicators: 
O-Optional 
R-Required 
Blank-Invalid 


Function 


This specifies the primary display 
size and any secondary display 
sizes. Valid entries for the 
parameter value are: 

*DS1or16 64 
*DS2 or 12 80 
*DS3 or 24 80 
(x, y, or z = 1, 2, or 3 
and X # y # z) 


Use of the Dup key is allowed. 


This names the edit code by which FLD 
field values are to be displayed. 


This specifies an edit word that 
describes the form in which values 
are to be displayed. 


One or more records are erased. 


*MDTON: Input-capable fields 
with MDTs set on are erased. 
*ALL: All input-capable fields are 
erased. 


This specifies the message to be 
displayed on the message line. 


This specifies the message 
identifier of the message to be 
displayed on the messages line. 


Retain all input data on the screen. 


Your program receives control FL 
when the Help key is pressed. _ RCD 

^Groups: 

CHK-Validity checking keywords 
CTL-Processing control keywords 
DSP-Display control keywords 
EDT-Data editing/field setting keywords 
KBD-Keyboard control keywords 
MSC-Miscellaneous keywords 
MSG-Message handling keywords 
REF-Naming and referencing keywords 
RTG-Routing keywords 
SFL(C)-Subfile control record keywords 
SFL(R)-Subfile record keywords 
TXT-Text definition keywords 


Option 

Indicators^ Groups^ 

























































DISPLAY FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

Level' 

Option 

Indicators^ 

Groups^ 

HOME 

[ (response-indicator 
['text'])] 

Your program receives control 
when the Home key is pressed and 
the cursor is already in the home 
position. 

FL 

RCD 

0 

0 

KBD 

KBD 

INDTXT 

(indicator 

'indicator-usage-text') 

Indicator text is to be associated 
with an indicator for high-level 
language program documentation. 



TXT 

TXT 

TXT 

INZRCD 


The record is written to the display 
before it is read. 

RCD 


DSP 

KEEP 


Erasing of the display is prevented 
when the file closes. 

RCD 


MSC 

LOCK 


The keyboard is not to be unlocked 
on a write operation. 

RCD 

0 

KBD 

LOGINP 


The input record is copied (logged) 
to the job log. 

RCD 


MSC 

LOGOUT 


The output record is copied 
(logged) to the job log. 

RCD 

0 

MSC 

LOWER 


See CHECK(LC) (the preferred 
spelling). 




MDTOFF 

r*UNPR\ 

\*ALL / 

*UNPR: MDTs of fields without 
DSPATR(PR) are reset on an 
output operation. 

*ALL: MDTs of ail fields are reset 
on an output operation. 

RCD 

0 

DSP 

MSGLOC 

(line-number) 

This specifies what line messages 
are to be displayed on. 

FL 

(See note.) 

MSG 

OPENPRT 


The print file is to remain open 
until the display file is closed. 

FL 


MSC 

'Level: 

FL-File level 

RCD-Record level 

FLD-Field level 

^Option Indicators: 

O-Optional 

R~Required 

Blank-Invalid 

^Groups: 

CHK-Validity checking keywords 

CTL-Processing control keywords 

DSP-Display control keywords 

EDT-Data editing/field setting keywords 

KBD-Keyboard control keywords 

MSC-Miscellaneous keywords 

MSG-Message handling keywords 

REF-Naming and referencing keywords 

RTG-Routing keywords 

SFL(C)-Subfile control record keywords 

SFL(R)-Subfile record keywords 

TXT-Text definition keywords 

Note: Screen size condition names can be used as indicators (*DS1, '^DS2, *DS3). 
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DISPLAY FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

Lever 

Option 

Indicators^ 

Groups^ 

OVERLAY 


The entire display is not erased 
before this record is displayed. 

RCD 

0 

DSP 

OVRATR 


Display attributes of this field are 
changed on an output operation. 

FLD 

0 

DSP 

OVRDTA 


Data contents of this field are 
changed on an output operation. 

FLD 

0 

DSP 

PASSRCD 

(record-format) 

This specifies the record format to 
be used when unformatted data is 
passed. 

FL 


CTL 

PRINT 

(response-indicator 
'text']) 

(printer-file-name 

[.library-name])] 

The Print key can be used to: 

• Print to the associated device. 

• Print to the specified printer file. 

• Pass control to your program. 

FL 

0 

(See note.) 

KBD 

PROTECT 


All input-capable field on the 
screens are changed to output-only 
fields. 

RCD 

0 

DSP 

PUTOVR 


Permits the use of OVRATR and 
OVRDTA keywords. 

RCD 

0 

DSP 

PUTRETAIN 


A record (at the record format 
level) or field (at the field level) on 
the display is retained. 

RCD 

FLD 

0 

0 

DSP 

DSP 

RANGE 

(low high) 

The field value must be within the 
range specified. 

FLD 


CHK 

REF 

(data-base-file-name 
[.library-name] 

[ record-format-name ]) 

The system refers to the data base 
file for field specifications for this 
display file. 

FL 


REF 

^ Level: 

FL-File level 

RCD-Record level 

FLD-Field level 

^Option Indicators: 

O-Optional 

R-Required 

Blank-Invalid 

^Groups: 

CHK-Validity checking keywords 

CTL-Processing control keywords 

DSP-Display control keywords 

EDT-Data editing/field setting keywords 

KBD-Keyboard control keywords 

MSC-Miscellaneous keywords 

MSG-Message handling keywords 

REF-NamIng and referencing keywords 

RTG-RoutIng keywords 

SFL(C)-Subfile control record keywords 

SFL(R)-Subfile record keywords 

TXT-Text definition keywords 

Note: A response indicator must be specified for this keyword to be used by COBOL. 
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DISPLAY FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

Level' 

Option 

Indicators^ 

Groups^ 

REFFLD 

(referenced-field-name 
[ .record-format-name] 
|*SRC 

Idata-base-file-name 

\ 

[.library-name]/) 

The system refers to the data base 
file (other than the file specified in 
the REF keyword) for field 
specifications for this display file. 

FLD 


REF 

ROLLDOWN 

[ (response-indicator 
[’text-])] 

Your program receives control 
when the Roll Down key is 
pressed. 

FL 

RCD 

0 

0 

KBD 

KBD 

ROLLUP 

[ (response-indicator 
('text'1)1 

Your program receives control 
when the Roll Up key is pressed. 


0 

0 

KBD 

KBD 

RTGAID 

(starting - routing -field - 
location) 

The AID byte (command key 
indication) is placed into the 
routing data as a 2-byte identifier. 

RCD 


RTG 

RTGCON 

(starting - routing -field - 
location 'constant') 

The specified literal is placed into 
the routing data at the specified 
location. 

RCD 


RTG 

RTGDEV 

(starting-routing-field- 

location) 

The 10-character device name is 
placed into the routing data. 

RCD 


RTG 

RTGDEVCLS 

(starting - routi ng -field - 
location) 

The 2-character device class is 
placed into the routing data. 

RCD 



RTGFIRST 

(starting-routing-field- 
location entry-length) 

The length and location of the first 
field received is placed in the 
routing data. 



RTG 

RTGFLD 

(starting-routing-field- 

location) 

The field data is placed in the 
routing data. 

FLD 


RTG 

RTGFMT 

(starting - routi ng -field - 
location) 

The record format name is placed 
into the routing data. 

RCD 


RTG 

RTGPOS 

(starting-routing-field- 

location 

starting-data-position 

ending-data-position) 

Data received from a display device 
is placed into the routing data. 

RCD 


RTG 

^ Level: 

FL-File level 

RCD-Record level 

FLD-Field level 

^Option Indicators: 

O-Optional 

R-Required 

Blank-Invalid 

^Groups: 

CHK-Validity checking keywords 

CTL-Processing control keywords 

DSP-Display control keywords 

EDT-Data editing/field setting keywords 

KBD-Keyboard control keywords 

MSC-Miscellaneous keywords 

MSG-Message handling keywords 

REF-Naming and referencing keywords 

RTG-Routing keywords 

SFL(C)-Subfile control record keywords 

SFL(R)-Subfile record keywords 

TXT-Text definition keywords 
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DISPLAY FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

Level^ 

Option 

Indicators^ 

Groups^ 

RTNDTA 


CPF returns the same input data as 
on the last input operation. 

RCD 


CTL 

SETOF 

(response-indicator 

r'texfl) 




MSC 



See SETOF (the preferred spelling). 




SFL 


The record format is a subfile 
record format. 

RCD 

■ 


SFL(R) 

SFLCLR 


This allows the clearing of a subfile 
(not the same as the deletion of a 
subfile). 

RCD 

R 

SFL(C) 

SFLCTL 

(record-format-name) 

The record format is a subfile 
control record format. 

RCD 


SFUC) 

SFLDLT 


This allows the deletion of a 
subfile. 


R 

SFUC) 

SFLDROP 

(CAnn/CFnn) 

This assigns a command key to be 
used to fold or truncate records of 
a subfile. 

■ 


SFL(C) 

SFLDSP 


This allows the display of the 
subfile. 

RCD 

0 

SFL(C) 

SFLDSPCTL 


This allows the display of the 
subfile control record. 

RCD 

0 

SFUC) 

SFLEND 


This allows the display of a plus 
sign when there are more subfile 
records than fit on one page. 

RCD 

R 

SFL(C) 

SFLENTER 

(CAnn/CFnn) 

This changes the Enter/Rec Adv 
key to a Roll Up key and assigns 
the specified command key to be 
Enter/Rec Adv key. 

RCD 


SFUC) 

SFLINZ 


This allows all records within the 
subfile to be initialized with one 
output operation. 

RCD 

0 

SFUC) 

^ Level: 

FL~File level 

RCD-Record level 

FLD-Field level 

^Option Indicators: 

O-Optional 

R-Required 

Blank-Invalid 

^Groups: 

CHK-Validity checking keywords 

CTL-Processing control keywords 

DSP-Display control keywords 

EDT-Data editing/field setting keywords 

KBD-Keyboard control keywords 

MSC-Miscellaneous keywords 

MSG-Message handling keywords 

REF-Naming and referencing keywords 

RTG-Routing keywords 

SFL(C)-Subfile control record keywords 

SFL(R)-Subfile record keywords 

TXT-Text definition keywords 
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DISPLAY FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

Lever 

Option 

Indicators^ 

Groups^ 

SFLLIN 

(spaces) 

This specifies the number of 
spaces between columns of subfile 
records. 

RCD 

(See note.) 

SFL(C) 

SFLMSG 

('message' [response- 
indicator]) 

This specifies the subfile-related 
message to be displayed on the 
message line. 

RCD 

0 

SFL(C) 

SFLMSGID 

(msgid msg-file 
[.library-name]) 

This specifies the message 
identifier of the subfile-related 
message to be displayed on the 
message line. 

RCD 

0 

SFL(C) 

SFLMSGKEY 


This field contains the message 
identifier (message key) of the 
message on a program message 
queue to be placed in a message 
subfile. 

FLD 


SFMR) 

SFLMSGRCD 

(line-number) 

The subfile is a message subfile 
and contains messages from a 
program message queue. 
SFLMSGRCD is valid on the subfile 
record format only. 

RCD 

(See note.) 

SFL(R) 

SFLNXTCHG 


Your program can force the work 
station user to rekey input fields 
correctly. 

RCD 

0 

SFL(R) 

^ Level: 

FL-File level 

RCD-Record level 

FLD-Field level 

^Option Indicators: 

O-Optional 

R-Required 

Blank-Invalid 

^Groups: 

CHK-Validity checking keywords 

CTL-Processing control keywords 

DSP-Display control keywords 

EDT-Data editing/field setting keywords 

KBD-Keyboard control keywords 

MSC-Miscellaneous keywords 

MSG-Message handling keywords 

REF-Naming and referencing keywords 

RTG-Routing keywords 

SFL(C)-Subfile control record keywords 

SFL(R)-Subfile record keywords 

TXT-Text definition keywords 

Note: Screen size condition names can be used as indicators (*DS1, ^DS2, *DS3). 
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DISPLAY FILE KEYWORDS (continued) 


Keyword Values 


SFLPAG 


(number-to-be-displayed) 



SFLPGMQ 


SFLRCDNBR [(CURSOR)] 


SFLRNA 


SFLROLVAL 


SFLSIZ 



(number-of-records- 

in-subfile) 


(nn|*VAR) 



^ Level: 

FL~File level 
RCD-Record level 
FLD-Field level 

^Option Indicators: 
O-Optional 
R-Required 
Blank-Invalid 



Function 


This specifies the number of 
subfile records that can be 
displayed at one time. If field 
selection is used in the subfile, this 
represents the number of display 
lines in the page. 


This field contains the name of the FLD 
program message queue containing 
messages to be placed in a 
message subfile. 


A page of a subfile is displayed 
according to a relative record 
number. 


This keyword enables a subfile to 
be initialized with no active 
records. 


The specified field and the 
appropriate Roll key are used to 
roll the subfile records that are 
displayed._ 


This specifies the number of 
records in a subfile. 


Line numbers for all fields in this 
record format are increased by nn 
or by the value of the field *VAR 
as set by your program before the 
record is displayed. _ 


This is a text description for a 
record format or field. 


The system time is displayed in the 
specified location. 


^Groups: 

CHK-Validity checking keywords 
CTL-Processing control keywords 
DSP-Display control keywords 
EDT-Data editing/field setting keywords 
KBD-Keyboard control keywords 
MSC-Miscellaneous keywords 
MSG-Message handling keywords 
REF-Naming and referencing keywords 
RTG-Routing keywords 
SFL(C)-Subfile control record keywords 
SFL(R)-Subfile record keywords 
TXT-Text definition keywords 


Note: Screen size condition names can be used as indicators (*DS1, *DS2, *DS3). 


Option 

Indicators^ Groups^ 


(See note.) SFL(C) 
















































DISPLAY FILE KEYWORDS (contiiHied) 


Keyword 

Values 

Function 

Level' 

Option 

Indicators^ 

Groups^ 

UNLOCK 

[‘ERASE |*MDTOFF]l 
[•ERASE *MDTOFF] 1 
•MDTOFF ‘ERASE] 

The keyboard is unlocked after an 
input operation so that the next 
record can be entered before the 
next output operation. 

RCD 


KBD 

USRDFN 


The data is a user-defined data 
stream. 

RCD 


DSP 

VALUES 

(value-1 [value-2... 
[value-2011) 

The field value must be one of the 
values specified. 

FLD 


CHK 

VLDCMDKEY 

(response-indicator 

['text*]) 

The response indicator is set on if 
a valid command key (a key 
associated with a keyword) is 
pressed. 

FL 

RCD 


KBD 

KBD 

'Level: 

FL-File level 

RCD-Record level 

FLD-Field level 

^Option Indicators: 

O-Optional 

R-Required 

Blank-Invalid 

' 

^Groups: 

CHK-Validity checking keywords 

CTL-Processing control keywords 

DSP-Display control keywords 

EDT-Data editing/field setting keywords 

KBD-Keyboard control keywords 

MSC-Miscellaneous keywords 

MSG-Message handling keywords 

REF-Naming and referencing keywords 

RTG-Routing keywords 

SFL(C)-Subfile control record keywords 

SFL(R)-Subfile record keywords 

TXT-Text definition keywords 
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DISPLAY FILE KEYWORDS-GROUP LISTING 


Data editing/field setting keywords (EDT) 

DATE 

DFT 

EDTCDE 

EDTWRD 

TIME 


Display control keywords (DSP) 

ALARM 

BLINK 

BLKFOLD 

CHECKIRL or RLTB only) 
CHGINPDFT 
I CLRL 

I CSRLOC 

DSPATR 
DSPSIZ 
ERASE 
ERASEINP 
GETRETAIN 
INZRCD 
MDTOFF 
OVERLAY 
I OVRATR 

I OVRDTA 

PROTECT 
I PUTOVR 

' PUTRETAIN 

I SLNO 

USRDFN 


Keyboard control keywords (KBD) 

CAnn 

CFnn 

CHECK(ER, FE. LC, RB, RZ) 

CLEAR 

DUP 

HELP 

HOME 

LOCK 

LOWER 

PRINT 

ROLLDOWN 

ROLLUP 

UNLOCK 

VLDCMDKEY 



Message handling keywords (MSG) 

ERRMSG 

ERRMSGID 

MSGLOC 


Miscellaneous keywords (MSC) 

ASSUME 

BLANKS 

KEEP 

LOGINP 

LOGOUT 

OPENPRT 

SETOF 

SETOFF 


Naming and referencing keywords (REF) 

DLTCHK 

DLTEDT 

REF 

REFFLD 


Processing control keywords (CTL) 

PASSRCD 

RTNDTA 


Routing keywords (RTG) 

RTGAID 

RTGCON 

RTGDEV 

RTGDEVCLS 

RTGFIRST 

RTGFLD 

RTGFMT 

RTGPOS 
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Subfile control record keywords (SFL(C)) 


SFLCLR 

SFLCTL 

SFLDLT 

SFLDROP 

SFLDSP 

SFLDSPCTL 

SFLEND 

SFLENTER 

SFLINZ 

SFLLIN 

SFLMSG 

SFLMSGID 

SFLPAG 

SFLPGMQ 

SFLRCDNBR 

SFLRNA 

SFLROLVAL 

SFLSIZ 


Subfile record keywords (SFL(R)) 
SFL 

SLFMSGKEY 

SFLMSGRCD 

SFLNXTCHG 

SFLPGMQ 


Text definition keywords (TXT) 

INDTXT 

TEXT 


Validity checking keywords (CHK) 


AUTO 

CHANGE 

CHECK(AB, ME, MF, M10, Mil, VN) 

CMP 

COMP 

RANGE 

VALUES 



DISPLAY FILE KEYWORDS-LISTED BY LEVEL 


File Level 


CAnn INDTXT 

CFnn MSGLOC 

CHECK(AB) OPENPRT 

CHECK(RL) and CHECK(RLTB) PASSRCD 

CHGINPDFT PRINT 

CLEAR REF 

DSPSIZ ROLLDOWN 

HELP ROLLUP 

HOME VLDCMDKEY 


Record Level 


ALARM 

ASSUME 

BLANKS 

BLINK 

CAnn 

CFnn 

CHANGE 

CHGINPDFT 

CLEAR 

CHECK(AB) 

CHECK(RL) 

CLRL 

CSRLOC 

ERASE 

ERASEINP 

GETRETAIN 

HELP 

HOME 

INDTXT 

INZRCD 

KEEP 

LOCK 

LOGINP 

LOGOUT 

MDTOFF 

OVERLAY 

PROTECT 

PUTOVR 

PUTRETAIN 

ROLLDOWN 

ROLLUP 

RTGAID 


RTGCON 

RTGDEV 

RTGDEVCLS 

RTGFIRST 

RTGFMT 

RTGPOS 

RTNDTA 

SETOF 

SETOFF 

SFL 

SFLCLR 

SFLCTL 

SFLDLT 

SFLDROP 

SFLDSP 

SFLDSPCTL 

SFLEND 

SFLENTER 

SFLINZ 

SFLLIN 

SFLMSG 

SFLMSGID 

SFLMSGRCD 

SFLNXTCHG 

SFLPAG 

SFLRNA 

SFLSIZ 

SLNO 

TEXT 

UNLOCK 

USRDFN 

VLDCMDKEY 
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AUTO 

BLKFOLD 

CHANGE 

CHECK(AB; ER; FE; LC; ME; MF; 

M10; Mil; RB; RZ; VN) 
CHECK(RL) 

CHGINPDFT 

CMP 

COMP 

DATE 

DFT 

DLTCHK 

DLTEDT 

DSPATR 

DUP 

EDTCDE 

EDTWRD 


ERRMSG 

ERRMSGID 

INDTXT 

LOWER 

OVRATR 

OVRDTA 

PUTRETAIN 

RANGE 

REFFLD 

RTGFLD 

SFLMSGKEY 

SFLPGMQ 

SFLRCDNBR 

SFLROLVAL 

TEXT 

TIME 

VALUES 




Display File Keywords-Combined Chart 


DispI 


Keyword 

Level 







S 

e 

i 






1 

s 

•a 





O 

H 





c 

s 


e 

•2 

§ 

x> 

e 

o 

e 

8 1 


IL 

flC 


O 

K £ 

ALARM 


X 

■ 

0 


■ 

ASSUME 


X 

B 



H 

AUTO(RA) 



B 

0 



AUTO(RAB) 



X 



Wa 

AUTO(RAZ) 



B 




BLANKS 



B 




BLINK 


X 


0 


Bjj 

BLKFOLD 


X 





CA01-CA24 

X 

X 


0 

0 


CF01-CF24 

B 

X 


0 



CHANGE 

H 

X 

X 

■ 

MM 


CHECK(AB) 

B 

X 

X 

B 

BB 

X 

CHECK(ER) 



X 

B 


X 

CHECK(FE) 



X 

B 

^B 

X 

CHECK(LC) 



X 

B 


X 

CHECK(ME) 



X 

B 

^B 

X 

CHECK(MF) 



B 

B 

^B 

X 

CHECK(MIO) 



B 

B 

^B 

X 

CHECK(MII) 



B 

B 

^B 

X 

CHECK(RB) 



B 

B 


X 

CHECK(RL) 

X 

X 

X 

B 

^B 

X 

CHECK(RLTB) 

X 



B 

^B 


CHECK(RZ) 



B 

B 


X 

CHECK(VN) 



B 

B 


X 

CLRL 


X 

B 

B 



CHGINPDFT 

X 

X 

B 

B 

^B 

X 

CMP 



B 

B 


X 

COMP 


1 

X 

u 

B 

X 


X = Allowed 
0 = Optional 
R = Required 
Blank = Not allowed 


Response Indicators 
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Inhibit 






















































Display File Keywords-Combined Chart (continued) 


Display File 


Keyword 



DLTCHK 

DLTEDT 

DSPATR(BL) 

DSPATR(CS) 

DSPATR(HI) 

DSPATR(MDT) 

DSPATRIND) 

DSPATR(OID) 

DSPATR(PC) 

DSPATR(PR) 

DSPATR(RI) 

DSPATR(SP) 

DSPATR(UL) 

DSPSIZ 

DUP 

EDTCDE 

EDTWRD 

ERASE 

ERASEINP 

ERRMSG 

ERRMSGiD 

GETRETAIN 

HELP 

HOME 

INDTXT 

INZRCD 

KEEP 

LOCK 

LOGINP 

LOGOUT 

LOWER 

MDTOFF 


X * Allowed 

Constant field only 
O * Optional 
R * Required 
Blank ~ Not allowed 
































































Display File Keywords-Combined Chart (continued) 




IL 


MSGLOC X 

OPENPRT X 

OVERLAY 

OVRATR 

OVRDTA 


PASSRCD 

X 

PRINT 

X 

PROTECT 


PUTRETAIN 


PUTOVR 


RANGE 


REF 

X 

REFFLD 


ROLLDOWN 

X 

ROLLUP 

X 

RTGAID 


RTGCON 


RTGDEV 


RTGDEVCLS 


RTGFIRST 


RTGFLD 


RTGFMT 


RTGPOS 


RTNDTA 


SETOF 


SETOFF 


SFL 


SFLCLR 


SFLCTL 


SFLDLT 


SFLDROP 


SFLDSP 


SFLDSPCTL 


SFLEND 


SFLENTER 




X - Allowed 
0 = Optional 
R ~ Required 
Blank » Not allowed 

* - Screen size condition names allowed 


Display File 
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Display File Keywords-Combined Chart (continued) 


Display File 


Keyword 

Level 


Usage 
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SFLMSG 
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SFLMSGIP 
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SFLMSGKEY 
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SFLNXTCHG 
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X 


■ 
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SFLSIZ 


X 


D 





SLNO 
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TEXT 
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TIME 
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UNLOCK 
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■ 
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USRDFN 
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■ 
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VLDCMDKEY 
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X « Allowed 
X^» Constant field only 
0 “ Optional 
R * Required 
Blank » Not allowed 

« » Screen size condition names allowed 


Keyboard Shifts 


i 

■e 

•o 

Z 


8 

8 

S 


£ 

JZ 

CO 

e 


4;: 

z 

CO 

E 

3 


E 

3 


I 

(0 


c 

O 


a 

< 


c 

O 

E 

3 


C 

s 

§ 


X 

X 


C-20 


Inhibit 










































Appendix D. Printer File Keyword Sumniary 


Keyword 

Values 

Function 

LeveP 

Option 

Indicators^ 

Groups^ 

BLKFOLO 


Records are folded at the last blank 
before the end of the line instead 
of folded at the actual end of the 
line. 

FLD 


PRT 

DATE 


The job date is printed in the 
specified location. 

FLD 


EDT 

DFT 

('litsral')l'literal' 

A field is initialized to a constant 
value. 

FLD 


EDT 

DLTEDT 


The edit information is ignored 
when referencing field 
specifications. 

FLD 


REF 

EDTCDE 

(edit-code 

[• 1 floating-currency 

-symbol]) 

This names the edit code by which 
field values are to be printed. 

FLD 


EDT 

EDTWRD 

('edit-word') 

This specifies an edit word that 
describes the form in which values 
are to be printed. 

FLD 


EDT 

INDTXT 

(indicator 'indicator-usage 
-texf) 

Indicator text is to be associated 
with an indicator for high-level 
language program documentation. 

Bl 


TXT 

TXT 

TXT 

PAGNBR 

‘ 

j 

A system-supplied page number is 
printed in this field (a 4-digit zoned 
decimal field). 

FLD 

0 

PRT 

'L«vel: 

FL-File level 

RCD-Record level 

FLO-Field level 

^Option Indicators: 

O-Optional 

R-Required 

Blank-Invalid 

^Groups: 

EDT-Editing and field setting keywords 

PRT-Printer control 

REF-Naming and referencing keywords 

TXT-Text definition keywords 


Printer File Keyword Summary 
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PRINTER FILE KEYWORDS (continued) 






Option 


Keyword 

Values 

Function 

Lever 

Indicators^ 

Groups^ 

REF 

(data-base-file-name 

The system refers to field 

FL 


REF 


[.library-name] 

specifications from a referenced 





[format-name]) 

data base file. 




REFFLD 

(referenced-field-name 

The system refers to field 

FLD 


REF 


[ record-format-name ] 

specifications from a data base file 





|*SRC 

(other than the file specified in the 





\data - base-f ile-name 

REF keyword). 





[.library-name ]J) 





SKIPA 

(skip-after-line-number) 

This specifies a line to skip to after 

FL 

R 

QQIIIII 



printing a line (file level), after 

RCD 

0 




printing an entire record (record 
format level), or after printing the 
line containing the field associated 
with this keyword (field level). 

FLD 

0 


SKIPS 

(skip- before- line- number) 

This specifies the line to skip to 


R 

IQIIIIIIII 



before printing the next line of 


0 




output (file level), or before printing 
the lines associated with a record 
(record format level), or before 
printing the line containing the field 
associated with this keyword (field 
level). 


0 


'Level: 


^Groups: 




FL-Flle level 


EDT-Editing and field setting keywords 



RCD~|Record level 

PRT-Printer control 




FLD-Field level 


REF-Naming and referencing keywords 





TXT-Text definition keywords 




^Option Indicators: 





O-Optional 

R-Required 

Blank-Invalid 
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PRINTER FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

Level' 

Option 

Indicators^ 

Groups^ 

SPACEA 

(space-after-value) 

This specifies the number of lines 
to space after printing an entire 
record (record format level) or to 
space after printing the line 
containing the field associated with 
this keyword (field level). 

RCD 

FLD 

0 

0 

PRT 

PRT 

SPACEB 

(space-before-value) 

This specifies the number of lines 
to space before printing the lines 
associated with a record (record 
format level) or before printing the 
line containing the field associated 
with this keyword (field level). 

RCD 

FLD 

0 

0 

PRT 

PRT 

TEXT 

('description') 

This is text description of the 
record format (record level) or 
descriptions of the field (field level). 

RCD 

FLD 


TXT 

TXT 

TIME 

1 


The system time is printed in the 
specified location. 

FLD 


EDT 

UNDERLINE 


The field is underlined. 

FLD 

0 

PRT 

^ Level: 

FL-File level 

RCD-Record level 

FLC-Field level 

^Option Indicators: 

O-Optional 

R-Required 

Blank-Invalid 

^Groups: 

EDT-Editing and field setting keywords 

PRT-Printer control 

REF-Naming and referencing keywords 

TXT-Text definition keywords 


PRINTER FILE KEYWORDS-GROUP LISTING 

Editing and field setting keywords (EDT) 


Printer control keywords (PRT) 


DATE 

DFT 

EDTCDE 

EDTWRD 

TIME 


Naming and referencing keywords (REF) 

DLTEDT 

REF 

REFFLD 


BLKFOLD 

PAGNBR 

SKIPA 

SKIPB 

SPACEA 

SPACEB 

UNDERLINE 


Text definition keywords (TXT) 

INDTXT 

TEXT 
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PRINTER FILE KEYWORDS-LISTED BY LEVEL 

ni«i«v«i 

INDTXT 

REF 

SKIPA 

SKIPS 


Racord Laval 

INDTXT 

SKIPA 

SKIPS 

SPACEA 

SPACES 

TEXT 


Fiald Laval 

SLKFOLD 

DATE 

DFT 

DLTEDT 

EDTCDE 

EDTWRD 

INDTXT 

PAGNSR 

REFFLD 

SKIPA 

SKIPS 

SPACEA 

SPACES 

TEXT 

TIME 

UNDERLINE 



Appendix E. Communications File and BSC File Keyword Summary 


Keyword 

Values 

Function 

UveP 

Option 

Indicators^ 

Groups^ 

ALWWRT 


The record currently being written 
ends a transmission; the program 
is going to receive state. 

FL 

RCD 

0 

0 

CTL 

CTL 

ENDGRP 


Indicates the end of a user-defined 
group of records. Your program 
remains in a send state. 

FL 

RCD 

0 

CTL 

FAIL 


Discard the records being sent in 
the current transmission. 

FL 

RCD 

0 

0 

CTL 

CTL 

INDTXT 

(indicator 

'indicator- usage-texf) 

Indicator text is to be associated 
with an indicator for high-level 
language program documentation. 

FL 

RCD 


TXT 

TXT 

RCVENDGRP 

(response-indicator 

['text-]) 

Indicates the end of a user-defined 
group of records sent to the 
program. 

FL 

RCD 


MSC 

MSC 

REF 

(data-base-file-name 

[.library-name] 

[ record-format-namel) 

The system refers to field 
specifications from a referenced 
data base file. 

FL 


REF 

REFFLD 

(referenced -field - name 
r .record-format-name ] 
rSRC 

\[ data-base-file-name 
[.library-name ]j) 

The system refers to field 
specifications from a data base file 
(other than the file specified in the 
REF keyword). 

FLD 


REF 

RQSWRT 


-i 

Requests permission from the host 
system so the user can send data. 

FL 

RCD 

0 

0 

MSC 

MSC 

RTGDEV 

(starting-routing-field- 

location) 

The 10-character device name is i 
placed into the routing data. 

RCD 


RTG 

^ Level: 

FL-File level 

RCD-Record level 

FLD-Field level 

^Option Indicators: 

0~0ptional 

R-Required 

Blank-Invalid 

^Groups: 

CTL-Processing control keywords 

MSC-Miscellaneous keywords 

REF-Naming and referencing keywords 

RTG-Routing keywords 

TXT-Text definition keywords 
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COMMUNICATIONS FILE AND BSC FILE KEYWORDS (continued) 


Keyword 

Values 

Function 

Lever 

Option 

Indicators^ 

Groups^ 

RTGDEVCLS 

(starting-routing- 

field-location) 

The 2-character device class is 
placed into the routing data. 

RCD 


RTG 

RTGFMT 

(starting-routing- 

field-location) 

The format name is placed into the 
routing data. 

RCD 


RTG 

RTGPOS 

(starting-routing- 
field-location 
starting-data- 
position ending- 
data-position) 

Data received from a device is 
placed into the routing data. 

RCD 


RTG 

TEXT 


This is a text description for a 
record format or a field. 

RCD 

FLD 


TXT 

TXT 

TRNRND 

(response- indicator 
['text*]) 

Indicates to the program that it is 
now in the send state and has ^ 
permission to write. 

FL 

RCD 


CTL 

CTL 

'Level: 

FL-Flle level 

RCD~Record level 

FLD-Field level 

^Option Indicators: 

O-Optional 

R-Required 

Blank-Invalid 

^Groups: 

CTL-Processing control keywords 

MSC-Miscellaneous keywords 

REF-Naming and referencing keywords 

RTG-Routing keywords 

TXT-Text definition keywords 
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COMMUNICATIONS FILE AND BSC FILE KEYWORDS-GROUP USTIN6 


Miscellaneous keywords (MSC) 

RCVENDGRP 

RQSWRT 


Naming and referencing keywords (REF) 
REF 

REFFLD 


Processing control keywords (CTL) 

ALWWRT 

ENDGRP 

FAIL 

TRNRND 


Routing keywords (RTG) 

RTGDEV 

RTGDEVCLS 

RTGFMT 

RTGPOS 


Text definition keywords (TXT) 

INDTXT 

TEXT 
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COMMUNICATIONS FILE AND BSC FILE KEYWORDS-LISTED BY LEVEL 


File Uvel 

ALWWRT 

ENDGRP 

FAIL 

INDTXT 

REF 

RCVENDGRP 

RQSWRT 

TRNRND 


Record Level 

ALWWRT 

ENDGRP 

FAIL 

INDTXT 

RCVENDGRP 

RQSWRT 

RTGDEV 

RTGDEVCLS 

RTGFMT 

RTGPOS 

TEXT 

TRNRND 


Field Uvel 

REFFLD 

TEXT 



Communications File and BSC File Keywords-Combined Chart 


Keywords 

Level 

Option Indicators 

Response Indicators 

Send State 

Receive State 

e 

il 

■s 

8 

« 

oe 

Field 

ALWWRT 

X 

X 


0 


Put 


ENDGRP 

X 

X 


0 


Put 


FAIL 

X 

X 


0 


Put 

Put 

RCVENDGRP 

X 

X 



R 


Get 

RQSWRT 

X 

X 


0 



Put 

TRNRND 

X 

X 



R 


Get 


X = Allowed 
O = Optional 
R = Required 
Blank = Not allowed 

Put = Can be selected only for output operations 

Get = Can be selected only for input operations _ 

Notes: 

1. If FAIL is in effect ALWWRT, ENDGRP, and RQSWRT are 
ignored. 

2. If RQSWRT is in effect and FAIL is not in effect ALWWRT and 
ENDGRP are ignored. 
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Appendix F. Examples 


This appendix describes sample data description specifications for each type of 
file covered in this manual. The samples chosen could be made to work with 
appropriate high-level language programs. Two such programs are shown in 
skeletal form to illustrate the use of externally described data. There are four 
sections in this appendix: 

• Data base files 

- A field reference file (a physical file used for reference, not data storage) 

- Two physical files 

- Two logical files 

• Device files 

- A simple menu 

- An inquiry display with two record formats 
Twelve subfile examples 

- A printer file 

- A communications file or a BSC file 

• Externally described data in RPG and COBOL 

- File specifications in RPG 

- The data division in COBOL 

• A sample compiler listing (output from a create file command) and the IBM 
Data Description Specifications Debugging Template (reduced) 


Examples F-1 



The following list describes each of the examples in this appendix: 


Data Base File Examples 

Example 1. Field Reference File 

. Important keywords: TEXT, COLHDG, EDTCDE(Z), REFFLD 

• One record format 

• Defines all fields used in an application 

• References fieids oniy within the field reference file itself 

Example 2, Physical File with a New Record Format 

• Important keywords: REF 

• One record format 

• Names of all fields in the record format are specified 

• References fields in a reference file (REF keyword) 

• Keyed sequence access path 

Example 3. Physical File Using FORMAT and a Keyed Sequence Access Path 

• Important keywords: UNIQUE, FORMAT 

• Composite key 

Example 4. Logical File Specifying New Keys 

• Important keywords: PFILE 

• New field specifications 

• Provides two record formats 

• Each record format uses a key different from the based-on physical file 

Example 5. Logical File Specifying a New Record Format 

• Important keywords: UNIQUE 

• Specifies a record format different from the based-on physical file 



Device File Examples 


Example 6. Simple Menu 

• Important keywords: BLINK, VALUES 

• Constant fields 

• Numeric-only, input-only fields 

Example 7. Inquiry Dispiay with Two Record Formats 

. Important keywords: PRINT, CAnn, CHECK, OVERLAY, EDTCDE(2 $), 
DSPATR(UL), DSPATR(HI BL), EDTCDE<YL ERRMSG 

• Use of +n to specify position 

Example 8. Work Station Dispiay Showing Subfile Operations 

. Important keywords: CAnn, DSPATR(HI), SETOF, ERRMSG, SFL, SFLCTL, 
SFLCLR, SFLDSP, SFLDSPCTL. SFLSIZ, SFLPAG 

• Option indicators (specified with and without N) 

• Four-step sequence of operations explained 

Example 9. Subfile with SFLPAG Vaiue Equai to SFLSIZ Value 

• Important keywords: SFLSIZ, SFLPAG, SFLDSP, SFLDSPCTL, SFLCLR, 
ROLLUP, ROLLDOWN 

• One column of subfile records 

• Constant fields in subfile control record format used as headings for 
columns of fields in subfile records 

Example 10. Subfile for Update without Validity Checking 

. Important keywords: CHECK(LC), CHECK(RB), UNLOCK(*ERASE *MDTOFF) 

• No validity checking keywords specified on subfile record format 


Permits rapid data entry to a transaction file that is run later to update 
existing records in the data base 



Example 11. Subfile for Update with Validity Checking 

. Important keywords: SFLNXTCHa COMP, DSPATR, DATE, TIME 

• Validity checking keywords and SFLNXTCHG in the subfile record format 
permit the program to ensure accurate data entry 

Example 12, Subfile with SFLINZ and SFLRNA Keywords 

. Important keywords: SFLNXTCHG, SFLINZ, SFLRNA 

• Display shows the subfile just after the program has initialized it; the 
program can write records to the subfile or the work station user can modify 
them 

Example 13. Subfile with SFLDROP Keyword 

• Important keywords: SFLDROP 

• Displays show the subfile in its two forms: folded and truncated 

Exampie 14. Subfile with Variable Length Records (Field Selection) 

• Important keywords: SFLPAG, SFLSIZ 

• The display shows a subfile in which some records are displayed with two 
fields and some are displayed with three fields 

Example 15. Subfile with Rolling by CPF 

• Important keywords: SFLPAG, SFLSIZ 

• SFLSIZ value is larger than SFLPAG value 

• Subfile is rolled by the SFLPAG value 

Example 16. Subfile with Rolling by CPF (SFLRCDNBR and SFLROLVAL Keywords) 

• Important keywords: SFLRCDNBR, SFLROLVAL 


Subfile is rolled by a certain number of records. 


Examf^ 17. Horizontal Subfile That Is Also Displayable on Two Display Sizes 

• Important keywords: SFLLIN, DSPSIZ 

• Subfile records appear in two columns (SFLLIN keyword) 

• Subfile can be displayed on two display sizes (DSPSIZ keyword) 

Example 18. Message Subfile 

• Important keywords: SFLMSGRCD, SFLMSGKEY, SFLMSGQ 

• Records in the subfile are first-level text of messages in a message file 

Example 19. Display File with Three Subfiles 

• Important keywords: OVERLAY, SFLDLT 

• The first display shows a horizontal subfile and a vertical subfile; the 
second display shows the horizontal subfile and a message subfile 

Example 20. Printer File 

• Important keywords: SKIPS, EDTCDE(Y), PAGNBR, EDTCDE(Z), SPACEA, 
UNDERLINE 

• This printer file uses space and skip keywords instead of line numbers 

Example 21. Commuricatiorts File or BSC File 

. Important keywords: ALWWRT, RQSWRT, FAIU RCVENDGRP, TRNRND 

• This file could be either a communications file (SNA protocol) or a BSC file, 
depending on the create file command used 

Externally Described Data In RPG and COBOL 

Example 22. File Specifications in RPG 

• For data base files (DISK) and display files (WORKSTN) with one subfile 

Example 23. Data Division in COBOL 


For a data base file 



DATA BASE FILES 


Example 1. Field Reference File 

The following field reference file (MLGREFP) describes all fields used by any 
program in the application. The other files reference the fields in this file. 

The following numbered items apply to Figure F-1: 

m Like all physical files, a field reference file has only one record format. 
The R in position 17 specifies that MLGREFR is the record format name. 

B The Rs in position 29 and REFFLD in positions 45 through 80 specify 

that the fields ADDR and CITY are to have the same attributes as NAME. 

B Specifying COLHDG for ADDR and CITY overrides the COLHDG attribute 
for NAME, which otherwise would have been in effect. 




Figure F-1. DDS for a Field Reference File 
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Example 2. Physical File with a New Record Format 


The following physical file (called CUSMSTP for customer master physical file) 

describes the fields physically present in the data base. The following 

numbered items apply to Figure F-2: 

B At the file level, the REF keyword refers CPF to the physical file 
MLGREFP, which is a field reference file for this data base. 

B At the record level, R in position 17 specifies that CUSMST is the record 
format name of the record in this file. (There can only be one record 
format in a physical file.) 

B At the field level, Rs in position 29 specify that the attributes of fields of 
the same name in the REF file are to be used as attributes of these 
fields. 

B fiolcl SEARCH is not defined in MLGREFP; therefore its field 
attributes are specified here. 

B At the key field level, K in position 17 specifies that CUST is the key field 
for the file. 



Figure F-2. DDS for a Physical File 






































Example 3. Physical File Using FORMAT and a Keyed Sequence Access Path 


The following numbered items refer to Figure F-3: 

H The UNIQUE keyword specifies that no records with duplicate key values 
can be placed into the physical file CUSMSTP2. 

01 The FORMAT keyword causes the physical file CUSMSTP2 to have the 
same record format as the physical file CUSMSTP. 

Q The key fields specify a composite key for the new file CUSMSTP2. 


IBM 


International Butina** Machine* Corporation 


DATA DESCRIPTION SPECIFICATIONS 


GX21-7764-1 UM/060* 
Printed in U.S.A. 


File 

Keying 

Instruction 

Graphic 



z 





Programmer | Date 

Key 









Description 


Page 


ET" 





Name 

B 19 20 21 22 23 24 25 26 27 28 


Length 

30 31 32 33 34 

^ Data Type (b A/P/S/B A/S/X/Y/N/l/W) 

ii 

II 

36 37 

5 

X 

5 

1 

8. 

1 

Location 

Functions 

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 6566 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

Sequence 

Number 

12 3 4 

5 

K 

E 

i 

6 

1 

1 

1 

7 

z 

S 

z 

§ 

Condition Name 

CD 

^ Indicator 
o 

z 

S 

z 

11 

1 

1 

12 13 

z 

1 

14 

1 
1 
15 16 

Line 

39 40 41 

Pos 

42 43 44 

la 

SE 

n 


□ 

a 










I 

r 

























a 


m 

Q 



m 

rr 

[a 

i 


fl 

rs 

IT! 

IE 

|CAt. 

fl 

[S 



a 


HI 

s 




1 

B 






J 

a 




a 

3 



J 







T 

T 



■ 









1 


-J 


fl 

fl 

fl 



B 


B 

s 

Z1 

s 


D 



1 

B 




B 

fl 

fl 

fli 

r 


z 










1 


z 





LL 

J 

M M M M i M 1 U M M 1 i 1 M M M i 



SI 

5 

a 

B 



1 

B 




B 

fl 

fl 

Ql 

IB 


B 

B 









J 


J 





j 2 1 

pOR.nATCCUSHSTp'i 


ms. 


B 




n 


B 

r 

o 


B 


IIS 

asm 

fl 











n 




fl 

fl 






□E 


a 


B 






B 

L 

o 

J 

B 

SI 


mm 

B 












B 

fl 

B 

fl 

B 

B 


B 









B 



1 




-j 





L 













_ 



B 

fl 

fl 

_ 


fl 









B 












r 












1 

1 

B 

B 

B 

B 

B 

B 


fl 









fl 



1 

1 








IB 

ms 

B 

B 

fl 

B 

B 

B 

fl 

fl 

fl 

fl 

fl 


B 

fl 

_ 



J 


1 









B 



_ 





B 

B 

B 


L 



_ 

_ 


_ 






Z 




fl 

fl 

B 



fl 









□ 












IB 


B 

B 

B 

B 

fl 

B 

B 

fl 

B 

B 

fl 


B 

B 

B 

B 

B 



B 









B 


























B 

B 

fl 

B 

B 



fl 









B 






B 

B 



















fl 

B 

B 

B 

fl 



B 









B 






B 

B 



















B 

B 

B 

B 

B 



B 









B 






B 

B 






























n 





B 





B 

B 

B 





IB 

IBB 

B 

B 

B 

fl 

B 

B 

B 

B 

B 

B 

fl 


fl 

fl 

B 






. 



1 





* 











T 
















n 


B 

B 

fl 

B 

B 

B 

B 

—MM—■JB—BWHBiamHHIpBMB 

B 





B 

1 

■ 

1 

B 


B 

B 

B 

B 

B 

Bl 















B 

B 

B 

fl 

B 

B 

B 

B 

B 

B 


fl 

■ 

■ 

■ 

■ 

B 

■ 

B 

B 

_ 


_ 

_ 

_ 

_ 

_ 

I 














□ 

_ 

- 

_ 

_ 



: 


_ 

_ 


J 


"Number of *heet* par pad may vary tUghtly. 


Figure F-3. DDS for a Physical File 


Note: See the FORMAT keyword description in Chapter 2, Physical Files, for 
an example of a physical file with an arrival sequence access path. 
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Example 4. Logical File Specifying New Keys 


The following numbered items refer to Figure F-4: 

m The two record formats (CUSMST1 and CUSMST2) in this logical file are 
based on the same physical file (CUSMSTP). 

Q Record format CUSMST1 has a key different from record format 

CUSIVIST2, providing the application program with a different sequence 
of the same records. 



•Wwwtoaf of ihwt ptr pad may vry riigihtly. 

I Figure F-4. DOS for a Logical Fite Specifying New Kays 


F-10 
























































Example 5. Logical File Specifying a New Record Format 

The following logical file (called CUSMSTL2 for customer master logical file 
two) references some of the fields in the physicai file CUSMSTP. Another 
logical file could name all fields, name fields in other physical fHes as well, 
concatenate fields, change the order of fields, rename fields, or choose 
different key fields. In this logical file, the programmer merely omitted some 
fields from the physical file. Note that this logical file is the sample used for 
the compiled source listing at the end of this appendix. 

The following numbered items apply to Figure F-5: 

Q The keyword PFILE (required for logical files) references CUSMSTP. In a 
physical file or in any device file, use REF (at the file level) instead of 
PFILE to reference other files. 

Q The field names do not have R specified in position 29 as they would in 
physical files or in any device file. 

B As in CUSMSTP, the field ACTNUM is treated as a key field. 



Figure F-5. DOS for a Logical File 
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DEVICE FILES 


Exampto 6. Simpl* Manu 

The following menu, described in the DDS in Figure F-6 would be displayed 
by issuing an output operation to the record format MENU. 

... n. .11 

Order Department Clerk Menu 

1. General menu 
90. Sign-off 




The following display file (named ORDOOBCD) contains the DDS for the order 

department clerk menu. 

The following numbered Items apply to Figure F-6: 

Q The menu is displayed when a program issues an output operation to the 
record format MENU. 

Q Five fields are displayed. The first four are constant fields that appear as 
words on the screen. 

Q The fifth field displayed is RESP. It is an input-only field and defaults to 
a single underline. (If Y is not specified in position 35, an input-capable 
field has an additional underscore to the right, for the sign.) 

Q Specifying VALUES(1 90) with field RESP causes validity checking to fail 
if any number other than 1 or 90 is keyed into RESP and entered. 

Q Specifying BLINK on the record format causes the cursor to blink. (The 
cursor is positioned by default to the input-capable field RESP.) 



Figure F-6. DDS for a Simple Display File 
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Example 7. Inquiry Display with Two Record Formats 


The following display is defined by the DDS in Figure F-7. It is displayed by 
output operations to the record formats PROMPT and RESPONSE. 


A/R INQUIRY 

Enter customer number: __ 

Name XXXXXXXXXXXXXXXXXXXXXXX 

Address XXXXXXXXXXXXXXXXXXXXXXX 
City XXXXXXXXXXXXXXXXXXXXXXX 

State XX Zip code NNNNN 

Total A/R balance tNNN,NNN.NN 
Credit limit # NNH»NNN.Nn 

Credit balance tNNN»NNN.NN ^ Over Limit 

Last payment $NNN»NNN.NN Last payment date NN/NN/NN 

Sales this year $NN»NNN»NNN.NN 
Sales last year tNN>NNN»NNN.NN 


CFl - End program CF2 - Return to prompt 
Customer number not found 




The following numbered items refer to Figure F-7: 

m The PRINT keyword allows the work station user to print the display at 
any time by pressing the Print key. 

Q An application program would display a prompt by issuing an output 
operation to the record format PROMPT, displaying the constant fields 
'A/R INQUIRY' and 'Enter customer number:', and the named field 
GUST. 

Q The CHECK(MF) keyword specifies that when the work station user keys 
into one position of the field GUST, he must key into all five positions 
before pressing the Enter/Rec Adv key, or an error message is displayed 
and the keyboard is locked. The user must press the Reset key and 
rekey through the input field. 

Q If record format PROMPT is displayed and your program sets on indicator 
40 when an output operation is issued to record format PROMPT, the 
error message 'Gustomer number not found' is displayed on the message 
line (line 24 of the 24-iine display unless the MSGLOG keyword is 
specified). The message is highlighted, field GUST is displayed with its 
image reversed, and the keyboard locked until the work station user 
presses the Reset key. 

Q After the work station user presses the Enter/Rec Adv key, the 

application program retrieves the desired information from the data base 
and issues an output operation to record format RESPONSE, displaying 
the fields described by items mi and m. 

Q The OVERLAY keyword specifies that an output operation to this record 
format (RESPONSE) does not cause the entire screen to be erased, as it 
would be by default. 

Q Five constant fields ('Name', 'Address', 'Gity', 'State', and 'Zip Gode') and 
five named fields (NAME, ADDRESS, GITY, STATE, ZIP) are grouped 
together on the display by the line/position specifications. NAME, 
ADDRESS, GITY, and STATE default to character-type fields (A in 
position 35) because no decimal positions are specified. ZIP^ a 
numeric-only, integer field (Y in position 35; 0 in position 37), so its 
display length equals its specified length. 

Q Seven named fields have constant fields located near them on the display 
to identify them as in Q. In addition, edit codes EDTGDE(2) and 
EDTGDE(Y) affect this display. EDTGDE(2) is used for monetary amounts. 
EDTGDE(Y) is used for dates. 

01 The DSPATR(UL) keyword underlines the output field GRDLMT. 

O If indicator 30 is set on when an output operation is issued to record 
format RESPONSE, then the constant field '*0ver Limit' is displayed 
highlighted and blinking. 

QQ Instructions to the work station user are generally located at the bottom 
of the display, just above the message line. 
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Figure F-7. Display with Two Record Formats 
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Example 8. Work Station Display Showing Subfile Operations 

The following displays illustrate what a work station user would see when 
using a subfile. The user answers an initial prompt, and the program displays 
the contents of a subfile. 


1. The initial prompt is displayed when the program issues an output 
operation to the record formats PROMPT and KEYS (lines 00800 and 
03700 of Figure F-8 [the DOS for this display]): 



2. The user keys the name BAKER in the input field and presses the 
Enter/Rec Adv key: 
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3. The program fills the subfile by reading records from a data base file and 
writing them to the subfile. When the subfile is full, the program issues 
an output operation to the subfile control record format SFLCTLR (see 
Figure F-8). 


The name Baker does not actually exist on the customer review; the 
program displays the next name in the alphabetical listing followed by as 
much of the customer review list as fits in one subfile page. 


The subfile 
control record 
SFLCTLR 
(line 02500) 


The subfile 
record SFLR 
(line 02100) 


Record 

format 

KEYS 

(line 03700) 


0- 




CUSTOMER REVIEW 




Name 

Address 

Number 


BOOTRILLf J. HOWARD 

975 E^ JOHNSON 

10015 


BOSWORTH, NORMAN 

4540 BOTH PLACE 

20111 


BREYER, SUSAN 

124 19TH STREET 

1001^ 


COLLIER, LAWRENCE B. 

777 BROADWAY 

10014 


CONSTANTS, JAMES A. 

696 S, MAIN 

20114 


COOKSEY, JAMES 

674 W, 14TH ST 

20117 


GERSALLA, BEVERLY 

632 NE 12TH ST 

20115 


HARRIN6W0RTH, JOHN 

1515 W- NICOLLET 

20116 


HARVELO, DAVID G. 

RRl 

10016 


HEIMER, JUDITH A. 

4110 S. ELM 

10019 


JOHN, J. YANG 

5123 W 56TH ST 

10011 


KAMP, HENRY 

376 W. ALICE 

20112 


KESLEY, ROBERT S. 

356 N. PACIFIC 

10006 


KYLE, JENNIFER A. 

722 N. RIVER DRIVE 

10009 


LOWREY, THOMAS A. 

135 19TH PLACE 

10004 


MC MILLER, SUSAN 

367 FOREST 

10014 


NOVACS, JEFFREY A. 

8080 NM 3RD PLACE 

10010 


CFl - End program 




_ 



. . .. . 

4. Because all names in the customer review do not fit on a single display. 


the user presses the CF3 key to display more data. 

The program then 


refills the subfile with more records, redisplays the subfile, sets option 


indicator 50 on, and redisplays KEYS: 



f ^ 




CUSTOMER REVIEW 




Name 

Address 

Number 


ROTHBERG, MELVIN 

321 Circle Drive 

20113 


SMITH, RICHARD 

111 15TH AVE 

10003 


STONE, HIRAM A. 

345 LAWRENCE 

1005 


THOMPSON, JESSE W. 

5005 W 50TH 

1006 


WILSON, MARGARET A. 

3131 E. 40TH AVE 

1007 


CFl - End program CF3 

- Roll up CF4 - First Display 


W. _ 



> 
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The following display file (Figure F-8) contains the DDS for the preceding 
displays. The first coding sheet shows the prompt and two messages; the 
second coding sheet shows the subfile record format and subfile control record 
format. 

The following numbered items apply to part 1 of Figure F-8: 

H Specifying CA01 (on line (X)5(X)) enables the work station user to return 
control to the program by pressing the CF1 key. Pressing the CF1 key 
sets response indicator 91 on. The CAnn keyword is specified instead of 
CFnn because CAnn does not pass input data to the program. If it were 
necessary to pass input data to the program, CFnn would be specified. 

Q When the program issues an output operation to the record format 

PROMPT, four fields are always displayed: two constant fields (on lines 
01000 and 01200) and one output/input field (NAME on line O^AOO). 

Q If the program issues an output operation to the record format PROMPT 
with the indicator 61 on, the error message specified with the ERRMSG 
keyword is displayed along with the four other fields in the record format. 

The keyboard is locked, the NAME field is displayed with its image 
reversed, and the error message appears on the message line (line 24). 
The work station user must press the Reset key and rekey the NAME 
field to escape the error condition. 

Q As in Q, if the program issues an output operation to the record format 
PROMPT with indicator 62 set on, the constant field specified on lines 
02(X)0 through 02200 is displayed as a highlighted field. 
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Figure F-8 (Part 1 of 2). Customer Review 
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The following numbered items apply to part 2 of Figure F-8: 

Q The subfile record format describes each record in the subfile. Each 

record has three fields, NAME, ADDR, and ACTNUM, which are referenced 
to the field reference file MLGREFP (see REF keyword in part 1 of Figure 
F-8). 


Q The first record of the subfile is displayed on line 5, with its fields 
NAME, ADDR, and ACTNUM beginning in positions 2, 27, and 52, 
respectively. Succeeding records of the subfile appear on the lines below 
it (see the display for step 3). 

Q The subfile control record format name is SFLCTLR. The fields 

associated with it (in this case, the four constant fields on lines 03200 
through 03600) are displayed when the program issues an output 
operation to it. 

Qj When the program sets option indicator 60 off and issues an output 
operation to the subfile control record format SFLCTLR, the subfile is 
cleared (SFLCLR). When the program sets option Indicator 60 on and 
issues an output operation to the subfile control record format SFLCTLR, 
the subfile is displayed (SFLDSP) and the subfile control record is 
displayed (SFLDSPCTL). 

Q Because SFLSIZ and SFLPAG are equal, your program must handle 
rolling the data by refilling the subfile. 

IQ The record format KEYS contains constant fields that are displayed at the 
bottom of the display (one line above the message line) to give 
instructions to the work station user. These constant fields are not 
specified in the subfile control record format because fields in the subfile 
control record format would then be both above and below fields in the 
subfile record format, and that is invalid. 
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Figure F-8 (Part 2 of 2). Customer Review 
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Example 9. Subfile with SFLPAG Value Equal to SFLSIZ Value 

The following display is defined by the DDS in Figure F-9. It is displayed by 
an output operation to the subfile control record format SFLCTL1. 



First Field 


Second Field 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXX 
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The following numbered items refer to Figure F-9: 

Q The subfile record format SFL1 and the subfile control record format 
SFLCTL1 together define one subfile. The parameter value for the 
SFLCTL keyword is the name of the subfile record format. 

Q Each subfile record is made up of two fields: FLD1 and FLD2. FLD1 is 
10 bytes long (11 bytes display length because it defaults to signed 
numeric); FLD2 is 16 bytes long. FLD1 is an input-only field; FLD2 is an 
output-only field. Eighteen subfile records would appear on the screen, 
with the first one on line 3 and the last one on line 20. For each subfile 
record on the screen, two fields (FLD1 and FLD2) would appear, with 
four spaces between FLDI and FLD2. 

Q SFLSIZ and SFLPAG (required keywords) have equal values (18). 

Therefore one page equals the whole subfile. For all subfiles, the value 
of the SFLPAG keyword is the number of subfile records displayed at any 
one time (unless the SFLDROP keyword or variable length records are 
used). 

Q SFLDSP (a required keyword) and SFLDSPCTL (an optional keyword) are 
specified with indicator 05. Therefore, when indicator 05 is set on, the 
subfile and subfile control records can be displayed by an output 
operation to the subfile control record format SFLCTL1. 

Q SFLCLR (an optional keyword) is specified with option indicator 05 
preceded by an N. When indicator 05 is set off, the subfile can be 
cleared by an output operation to SFLCTL1. 

Q ROLLUP (an optional keyword) is specified with response indicator 01, 
and ROLLDOWN (an optional keyword) is specified with response 
indicator 02. Note also that the entire subfile equals one page, 
which means that the whole subfile is displayed at one time. Therefore, 
when the work station user presses the Roll Up key, control passes to 
the program with indicator 01 on, and when the work station user 
presses the Roll Down key, control passes to the program with indicator 
02 on. The program must handle rolling, by reading, clearing, rewriting, 
and redisplaying the subfile. Without ROLLUP and ROLLDOWN 
specified, the work station user would receive an error message when 
pressing the Roll Up or Roll Down key. 

Q Two constants ('First Field' and 'Second Field') are displayed when the 
subfile control record is displayed (SFLDSPCTL In effect). As specified in 
this subfile, they act as column headings to the subfile records. 
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Figure F-9. Subfile with Subfiie Size Equal to Subfile Page 
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Example 10. Subfile for Update without Validity Checking 


The following display shows the subfile defined in Figure F-10. The subfile 
contains records to be updated. A work station user could key into as many 
fields as required, probably not changing all the records. When the work 
station user presses Enter/Rec Adv key, the program reads only the records 
that have been changed (issuing Get-Next-Changed operations), accepting 
records without validity checking and building a transaction file with the 
changed records. Only when the transaction file is run against a master file is 
validity checking performed. 


r 




INVENTORY UPDATE 


ITM NBR 

DESCRIPTION 

AMOUNT 

UNITS 

NLOl 

NAILS 

6 

BOX 

NL04 

NAILS 

18 

BOX 

NLIO 

NAILS 

2 

BOX 

NL12 

NAILS 

14 

BOX 

NL14 

NAILS 

21 

BOX 

NL20 

NAILS 

1 

BOX 

SC02 

SCREWS 

13 

BOX 

SC 04 

SCREWS 

10 

BOX 

SC05 

SCREWS 

20 

BOX 

SC06 

SCREWS 

20 

BOX 

SCO? 

SCREWS 

24 

BOX 

SC08 

SCREWS 

20 

BOX 

SC20 

SCREWS 

10 

BOX 

SC21 

SCREWS 

2 

BOX 

SC23 

SCREWS 

4 

BOX 

SC25 

SCREWS 

4 

BOX 

SC27 

SCREWS 

2 

BOX 


CFl - End program CF2 - Cancel updates 








The following numbered items refer to Figure F-10: 

B CHECK(RB) is specified for the fields ITMNBR and AMOUNT so that 
when the work station user keys into these fields, the keyed values are 
right-adjusted and blank-filled in the displayed fields. CHECK(LC) is 
specified for the field DESCR so that the work station user can key in 
lowercase characters to be passed to the program. Without CHECK(LC), 
lowercase characters keyed into DESCR are automatically converted to 
uppercase characters before being passed to the program. 

B The UNLOCK keyword, specified on the subfile control record format, 
with the parameter value (*ERASE *MDTOFF), permits the work station 
user to continue keying in immediately after pressing the Enter/Rec Adv 
key. The program does not have to issue another output operation to the 
subfile control record format after issuing an input operation to unlock 
the keyboard. 

B A separate record format KEYS is necessary because the field locations 
for any one record format cannot interrupt the field locations for any 
other record format. 
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Figure F-10. Subfile for Update without Validity Checking 
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Example 11. Subfile for Update with Validity Checking 


The following display shows the subfile defined in Figure F-11. The subfile 
contains records that the work station user has tried to update. Two of them 
m have failed a validity check performed by the program. The two fields in 
error are displayed with their images reversed, and the first relevant error 
message Q is displayed on the message line (line 24). 


INVENTORY UPDATE 


ITH NBR 

DESCRIPTION 

AMOUNT 

UNITS 

NLOl 

NAILS 

6 

BOX 

NL04 

NAILS 

le 

BOX 

NLIO 

NAILS 

2 

BOX 

NL12 

NAILS 

14 

BOX 

NL14 

NAILS 

21 

BOX 

NL20 

NAILS 

1 

BOX 

SC02 

SCREWS 

13 

BOX 

SC04 

SCREWS 

10 

BOX 


SCREWS 

20 

BOX 

SC06 

SCREWS 

_ 20 

BOX 

3C07 

SCREWS 

24 

BOX 

SC08 

SCREWS 

20 

BOX 

SC20 

SCREWS 

10 

BOX 

SC21 

SCREWS 

2 

BOX 

1r:::S6S5 

SCREWS 

4 

BOX 

scSf^ 

. 

4 

BOX 

SC27 

SCREWS 

_2 

BOX 




CFl - End program CF2 - Cancel updates 
Invalid item number 


Date: NN/NN/NN 
Time: NN:NN:NN 
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The following numbered items refer to Figure F-11: 

Q When the work station user presses the Enter/Rec Adv key, the program 
issues Get-Next-Changed operations to the subfile record format SFLR. 

If the data keyed into the fields fails any validity checking performed by 
the program, the program can issue update operations to the records that 
have failed, setting on indicator 15 each time and setting indicators 16, 

17, 18, and 19 as necessary to select the DSPATR(RI PC) keywords and 
the SFLMSG keywords for the fields in error. 

When the program displays the subfile by issuing an output operation to 
SFLCTLR, the fields selected have their images reversed, the cursor is 
positioned to the first selected field on the display, and the error 
message applying to the first field selected is displayed on the message 
line (line 24). 

Q Four constant fields are specified for date and time. They are 'Date:' and 
'Time:' and the two fields associated with the DATE and TIME keywords 
(identified only by their locations). 

Q A separate record format KEYS is specified so that the instructions 
describing valid command keys can be displayed at the bottom of the 
display. (The constant fields displaying these instructions cannot be 
specified on the subfile control record format if the locations of the fields 
are below the subfile records.) Note that the CFnn keywords are 
specified at the file level, so they are always in effect. 
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Figure F-11. Subfile for Update with Validity Checking 
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Example 12. Subfile with SFLINZ and SFLRNA Keywords 

The following display shows a subfile defined in Figure F-12. The subfile has 
been initialized using the SFLINZ and SFLRNA keywords. The subfile is 
displayed, and either the program or the work station user can enter records. 
(At this point the records are inactive, although the subfile is active.) 


r 


SUBFILE WITH SFLINZ AND SFLRNA KEYWORDS 
FIELD ONE FIELD TWO FIELD THREE 


00000 

00000 

00000 

00000 

00000 

00000 


Value 

Value 

Value 

Value 

Value 

Value 


CFl - End program 




The following numbered items refer to Figure F-12: 

Q For this display, the program has Issued an output operation to SFLCTLR 
with indicators 01, 02, and 04 set on. The subfile is active; the subfile 
records are not active and not modified. To modify subfile records, the 
program can issue output operations to individual subfile records or the 
work station user can key changes. A Get-Next-Changed operation does 
not retrieve subfile records until at least one record has been modified. 

Q As initialized, the three input-only fields in the subfile record format 
appear as follows: 

Field Type Displayed Value 

FIELD1 Character Blanks 

FIELD2 Numeric Zeros 

FIELDS Character Specified constant 

(constant specified) (Value) 

Q The SFLINZ keyword is required for the SFLRNA keyword. 
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Example 13. Subfile with SFLDROP Keyword 

The following two displays show a subfile defined by the DDS in Figure F-13. 
In the first display, the records are displayed in the truncated form, as shown 
in this display (FIELDS is not displayed). 

The second display shows the subfile with records in the folded form (after the 
CF3 key has been pressed once). To switch from one form to the other, the 
work station user presses the CF3 key (as specified on the SFLDROP 
keyword). 


FIELD ONE 


SUBFILE WITH SFLDROP KEYWORD 
FIELD TWO 


FIELD THREE 
XXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxx 

XXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxx 


xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 


CF3 - Fold/truncate 




FIELD ONE 


SUBFILE WITH SFLDROP KEYWORD 
FIELD TWO 


FIELD THREE 

xxxxxxxxxxxxxxxxxxxx 

NNmNNNN 

xxxxxxxxxxxxxxxxxxxx 

NNNNNNNN 

xxxxxxxxxxxxxxxxxxxx 

NNNNNt^NN 

xxxxxxxxxxxxxxxxxxxx 

NNNNNf^NN 

xxxxxxxxxxxxxxxxxxxx 

NNNNNNNN 

xxxxxxxxxxxxxxxxxxxx 

NNNNNNNN 

xxxxxxxxxxxxxxxxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXXXXXXXX 

NNNNNNNN 


XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 


CF3 - Fold/truncate 
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The following numbered items refer to Figure F-13: 

B FIELDS is specified on the subfile record format with locations on the 
display line following the initial line specified for subfile records; 
therefore, its display can be controlled by pressing CF3 (see item Q). 

n The SFLDROP keyword specifies that the CF3 key is to be the Drop key. 
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Figure F43. Subfile with SFLDROP Keyword 
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Example 14. Subfile with Variable Length Records (Field Selection) 

The following display shows a subfile defined by the DDS in Figure F-14. This 
example illustrates the use of setting option indicators (specified in the subfile 
record format) to vary the length of subfile records. 




SUBFILE WITH VARIABLE LENGTH RECORDS 


FIELD ONE 

FIELD THREE 

XXXXXXXXXXXXXXXXXXXX 

NNNNNNNN 

XXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXX 

NNNNNNNN 

XXXXXXXXXXXXXXXXXXXX 

NNNNNNNN 

XXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXX 

NNNNNNNN 

XXXXXXXXXXXXXXXXXXXX 

NNNNNNNN 

XXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXX 

CFl - Return 


FIELD TWO 


XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
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The following numbered items refer to Figure F-14: 


Option indicator 26 is specified for FIELDS. By setting option indicator 
26, the program can select or not select FIELDS when issuing output 
operations to SFLR (writing records to the subfile). The lengths of 
records in the subfile varies depending on how FIELDS Is selected. 

You cannot control the display of the constant field 'FIELD THREE' when 
the work station user presses the Drop key. 
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Figure F-14. Subfile with Variable Length Records (Field Selection) 
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Example 15. Subfile with Rolling by CPF 


The following display shows a subfile that because the SFLSIZ value is larger 
than the SFLPAG value, can be rolled by pressing a Roll key without requiring 
any activity on the part of the program. CPF rolls the subfile unless the roll 
would go past the top or bottom of the subfile, in which case an error 
message is displayed. The DOS for this display is shown in Figure F-15. 


NAME 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 


DEPARTMENT 

PHONE 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 

XXXXXXXXXX 

NNNN 
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The following numbered item refers to Figure F-15: 


Q With the SFLSIZ value greater than the SFLPAG value, CPF can roll the 
subfile when the work station user presses a Roll Up or a Roll Down key. 
The program is unaware of the page being displayed. CPF rolls the 
subfile page by page (that is, by 17 records each time). For a description 
of rolling the subfile by page, see the ROLLUP/ROLLDOWN keyword 
description. For an example of rolling the subfile by other than the page 
value, see example 16. 
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Figure F-15. Subfile with Rolling by CPF 
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Example 16. Subfile with Rolling by CPF (SFLRCDNBR and SFLROLVAL 
Keywords) 

The following display shows the subfile defined in Figure F-16. This example 
is similar to example 15, except that the work station user can key into a field 
to select how far to roll the subfile. 


r 


Enter number of records to roll by: 


NAME DEPARTMENT PHONE 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXX NNNN 


The following numbered items refer to Figure F-16: 

Q When the work station user presses a Roll Up or a Roll Down key, the 
default is to roll one page of records (17 records for this subfile). 

Q When the program displays the subfile, it first sets the value of RCDNBR 
to the relative record number of a subfile record to be displayed. When 
the subfile is first displayed, the page containing that subfile record is 
displayed and the cursor positioned at field NAME in the subfile record 
whose relative record number is in RCDNBR. 

Q If the work station user keys a number into the field ROLLBY, then 
presses the Roll Up (or Roll Down) key, CPF adds (or subtracts) that 
number from the relative record number of the first record currently on 
the display, and displays the page of records beginning with the resulting 
relative record number. 


Examples 
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Figure F-16. Subfile with Rolling by CPF (SFLRCDNBR and SFLROLVAL Keywords) 
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Example 17. Horizontal Subfile That Is Also Displayable on Two Display Sizes 


The following two displays show the subfile defined in Figure F-17 as it 
appears on the 12 by 80 and 24 by 80 screen sizes, respectively: 







COLUMN I 

COLUMN 2 



XXXXXXXXXXXXXXXX 
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The following numbered items refer to Figure F-17: 

Q There is one keyword at the file level, the keyword DSPSIZ (an optional 
keyword). This keyword has two values, *DS2 and *DS3, which state 
that the primary screen size is 12 lines by 80 characters and the 
secondary screen size is 24 lines by 80 characters. Lacking *DS1, this 
display file cannot be opened to the system console. 

Q The SFLPAG keyword (a required keyword), is specified once with a 
value of 16 and again with a value of 40. The first time it applies to a 
device with the primary screen size (default of *DS2, or 12 lines by 80 
characters); the second time, coded with a condition name of *DS3, it 
applies to a device with the secondary screen size (24 lines by 80 
characters). 

Q The SFLLIN keyword causes a subfile to be displayed horizontally. The 
parameter value specifies the number of spaces between columns of 
records. In this example, five spaces separate columns of records on 
both the 12 by 80 screen size (*DS2) and the 24 by 80 screen size 
(*DS3). Because *DS2 is the primary screen size, it does not need to be 
specified in positions 9 through 12. 
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Figure F-17. Horizontal Subfile on Two Screen Sizes 
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Example 18. Message Subfile 


The following display shows the message subfile defined in Figure F-18: 


MESSAGE SUBFILE 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ♦ 





The following numbered items refer to Figure F-IS: 

Q Specifying the SFLMSGRCD keyword on the subfile record format 

identifies this subfile as a message subfile. The parameter value specified 
causes the subfile to be displayed on line 3 of the display. 

Q The fields MSGKEY and PGMQ are user-defined names given to the two 
fields required for the subfile record format for a message subfile. The 
only specifications allowed for them are their names and the 
SFLMSGKEY and SFLPGMQ keywords, in the order shown. 

This subfile is built by a series of output operations to SFLR that place 
messages in the subfile as subfile records. Messages are truncated to fit 
single lines (76 characters or 61 characters, depending on screen size), 
and second-level help text is available. This subfile is displayed by an 
output operation to SFLCTLR with option indicator 01 set on. 

Q This subfile is rolled by CPF when the work station user presses a Roll 
Up or a Roll Down key. The SFLEND keyword allows CPF to display a 
plus sign whenever the subfile can be rolled up. 
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Figure F-18. Message Subfile 
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Example 19. Display File with Three Subfiles 


The following two displays show the three subfiles defined in Figure F-19. In 
the first display, two of the three subfiles are displayed. Subfile 1 is a 
two-column subfile showing what items a particular account has on order. 
Subfile 2 is a single-column subfile showing which customers have ordered a 
particular item in stock. 


This display might be used by a shipping clerk who is allocating in-stock Items 
to customer orders. As the clerk allocates the items, he would enter the 
amounts to be shipped into the QTY SHIPD input fields. If the in-stock 
amount drops below a certain amount, the message subfile could be 
displayed. 




THREE SUBFILES: SUBFILE I AND SUBFILE 2 

Enter account number to look up: _ Account number not found 

Items 0/0 for XXXXXXXXXXXXXXXXXXXX 


ITEM NBR 

DESCRIPTION 

STATUS 

ITEM NBR 

DESCRIPTION 

STATUS 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

XXXXXX 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNfM^NN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 

NNNNNNNN 

XXXXXXXXXXXXXX 

xxxxxx 


Enter item number: _ 

Customers that have ordered item XXXXXXXXXXXXXX 


CUSTOMER NAME 
XXXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxxx 

XXXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxxx 

XXXXXXXXXXXXXXXXXXXXX 


ACCOUNT NBR 

DATE ORDERED 

QTY 0/0 

NNNNNNNNNNN 

NN/NN/NN 

NNNNNN 

NNNNNNNNNNN 

NN/NN/NN 

NNNNNN 

NNNNNNNNNNN 

NN/NN/NN 

NNNNNN 

NNNNNNNNNNN 

NN/NN/NN 

NNNNNN 

NNNNNNNNNNN 

NN/NN/NN 

NNNNNN 


QTY SHIPD 




CFl - End program CF2 - Look up new account CF3 - Look up new item 
Item number not found 


>Subfile 1 




VSubfile 2 
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In the second display the message subfile displays messages pertaining to the 
items the shipping clerk has tried to allocate to the order being filled, such as 
when items were back-ordered and expected arrival dates. 

Note: Subfile 2 must be deleted before the message subfile is built; it is the 
responsibility of the program to save any important data before deleting a 
subfile. 


THREE SUBFILES: SUBFILE 1 AND MESSAGE SUBFILE 


Enter account number to look up: ^ 
Items 0/0 for XXXXXXXXXXXXXXXXXXXX 
ITEM NBR DESCRIPTION STATUS 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 


_ Account number not found 

ITEM NBR DESCRIPTION STATUS 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 
NNNNNNNN XXXXXXXXXXXXXX XXXXXX 




MESSAGE SUBFILE STARTS ON NEXT LINE 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ♦ 


VSubfile 1 


I Message 
f Subfile 




The following numbered items refer to part 1 of Figure F-19: 

B The program can select which command keys are in effect by setting 
option indicator 50. The CF and CA keywords are specified at the file 
level, so the response indicators specified with the CF and CA keywords 
are returned to the program on any input operation issued to any record 
format. 

01 Subfile 1 is a horizontally displayed subfile; there are 16 records in a 
page, displayed in two columns of eight records each, with six spaces 
between columns. There are 64 records in the entire subfile. 

0| Specifying the OVERLAY keyword in the subfile control record format 
permits the program to display subfile 1 without erasing other records on 
the display. 

Q If the account number entered into the fields ACCTNBR1 is invalid, the 
program can redisplay the field with its image reversed and can position 
the cursor at the field. To do this, the program issues an output 
operation to SFLCTL1 with option indicators 02 and 91 set on. (The 
constant field 'Account number not found' is displayed as a highlighted 
field.) 
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Figure F-19 (Part 1 of 4). Three Subfiles in One Display File 


F-52 

















































































The following numbered items refer to part 2 of Figure F-19; 


Q Subfile 2 is a vertically displayed subfile; there are five records in a page, 
displayed in one column (the SFLLIN keyword is not specified). There are 
25 records in the entire subfile. 

Q Specifying the SFLDLT keyword with an option indicator enables the 
program to delete this subfile when a third subfile is to be built and 
displayed. To delete the subfile, the program issues an output operation 
to SFLCTL2 with option indicator 05 set on. 
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Figure F-19 (Part 2 of 4). Three Subfiles in One Display File 
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The following numbered items refer to part 3 of Figure F-19: 

Qj Specifying SFLMSGRCD in the subfile record format for SFL3 makes 

SFL3 a message subfile. The SFLMSGKEY and SFLPGMQ keywords are 
required on the two fields specified in the subfile record format of a 
message subfile. These two fields are names MSGKEY and PGMQ in 
this example. 

Q The SFLDLT keyword permits the program to delete this subfile after it 
has been built and displayed by issuing an output operation to SFLCTL3 
with option indicator 05 set on. 

Q The program can build this message subfile in one of two ways by 
setting option indicators: 

• A multiple output operation (issued to SFLCTL3) places several records 
in the subfile with one output operation. For this example, option 
indicator 08 must be set on for the multiple output operation. 

• The program can build the message subfile with as many single output 
operations as required by first setting off option indicator 08. Then, 
the program can determine the value of the fields MSGKEY and 
PGMQ for each output operation to SFL3. 




Figure F-19 (Part 3 of 4). Three Subfiles in One Display File 
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The following numbered items refer to part 4 of Figure F-19: 

HQ To change the title to match the displayed subfiles, the program sets 
indicator 50 as required and issues an output operation to TITLES. 

QQ To change the instructions displayed at the bottom of the screen when 
displaying the message subfile or replacing it with subfile 2, the program 
sets option indicator 50 as required and issues an output operation to 
KEYS. (Setting the indicator also affects the command keys specified at 
the file level; see part 1 of Figure F-19.) 
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Figure F-19 (Part 4 of 4). Three Subfiles in One Display File 
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Example 20. Printer File 


The following printer file contains DDS for printing a customer master list. 

The following numbered items apply to part 1 of Figure F-20: 

Q This printer file references the field reference file MLGREFP. 

Q When SKIPB(2) is specified at the record level, the printer skips to line 2 
before printing the record format (HEADER). Also, line numbers in 
positions 39 through 41 are invalid. 

Q UNDERLINE is a field level keyword that causes the constant field 
preceding it to be underlined on the printout. 


Examples 
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Figure F-20 (Part 1 of 2). Printer File 
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The following numbered Item applies to part 2 of Figure F-20: 

Q The REFFLD keyword specifies that ACTNBR is to have the same 
attributes as ACTNUM; ACTNUM is defined in file MLGREFP as 
specified on the REF keyword in part 1 of this figure. 
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Figure F-20 (Part 2 of 2). Printer File 
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Example 21. Communications File or BSC File 


The following communications file or BSC file contains DOS for transmitting 

data between System/38 and a remote system or device. 

The following numbered items apply to Figure F-21: 

Q Two record formats are specified for this file. In the send state, INQ is 
used; in the receive state, ANS is used. 

Q When your program can no longer continue a session, it selects the FAIL 
keyword by setting on option indicator 15 and issuing an output 
operation. 

Q When option indicator 10 Is set on, the ALWWRT keyword allows CPF to 
inform the remote system or device that the program has finished 
sending. 

Q When option indicator 11 is set on, the RQSWRT keyword allows CPF to 
request permission to send data. 

Q The RCVENDGRP keyword allows response indicator 13 to be set on at 
the end of a user-defined group of records. 

Q The TRNRND keyword allows response indicator 14 to be set on when 
the remote system or device has stopped sending. 

For more Information on how to use communications files and BSC files, see 

the Data Communications Programmer's Guide. 



International Butinett Machine* Corporation 
File 

Programmer I Date 


DATA DESCRIPTION SPECIFICATIONS 


GX21-7754-1 UM/OSO* 
Printed in U.S.A. 


Graphic 

z 


z 


z 



Key 

_i 








2 3 4 5 6 7 


Fk 

B 17 18 19 20 21 22 23 24 25 


g « O Line Po» 

J c« 

& S I 

6 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 65 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 8 

_—^-^^-^-r 


ggsifl^Tir— 


wmfwumwmimmm 
s?52saiiaHF““""“ 
gifeg fliii 


i BjaiaDpiaiiaM 2 

iBffg iwii i iiM iM 

111 


III 

Jlkia.£BH_ 

ggjrRMMlWIMMi ffigfia WWII 

ssn^Dimniiir 



wmsmumMUMmwK ~ 
isif?5flr 


-^QinmniHMiHHii 

IDIIHM«r 



IDIIHIHimil 






*Number of thaati per pad may vary dightly. 


Figure F-21. Communications or BSC File 
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EXTERNALLY DESCRIBED DATA IN RPG AND COBOL 


File Specifications in RPG 

The following RPG specifications are shown only in part to illustrate how 

externally described data is specified in an RPG program. 

The following numbered items apply to Figure F-22: 

H The E in position 19 of the file specifications refers to the external 
descriptions (the DDS). 

Q The DDS from the logical data base file CUSMSTL and from the display 
file CUSRVWD would be included in the output of the compilation of this 
program. 

Q The relative record field RECNUM is used in the program to read and 
write records to the subfile. 


The subfile record format name is SFLR. 
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Figure F-22. A Partial RPG Program Showing How to Specify Externally Described Data 
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Data Division in COBOL 


The following partial COBOL program illustrates how externally described data 
is specified in a COBOL program. 

The following numbered items apply to Figure F-23: 

Q The COBOL program refers to file CUSMSTL as CUST-MASTER. 

Q The COPY verb specifies that the record format CUSREC of logical file 
CUSMSTL is to supply the data descriptions for file CUSMSTL. The 
COBOL program refers to CUSREC as CUST-REC. 
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Figure F’23. A Partial COBOL Program Showing How to Specify Externally Described Data 
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SAMPLE COMPILER LISTING 


Title I 
Prolog / 


/ 


Source < 


Once data description specifications are written, they must be put into a source 
file. Then, data base or device files are created by entering the CL command 
that invokes the data description processor. The CL command can be entered 
interactively or in a batch job. The data description processor retrieves the data 
description specifications from the source file designated on the create file 
command, validates the specifications, and creates an output listing with any 
errors and any referenced specifications. 

A sample data description specifications compiler listing follows: 



57L4SS1 R03 NOO 811204 


DATA DESCRIPTION 



CUSMSTL.SC217806 08/07/81 15:43:17 


File name - 
Source file - 
Type of data - 
Options - 
Authority - 
Text - 
Compiler - 


CUSMSTL.SC217806 
Q00SSRC.SC217806 
*0ATA 
*SRC «LIST 
^NORMAL 

Sample listing for DOS manual 

IBM System/38 Data Description Processor 


DATA DESCRIPTION SOURCE 



08/07/81 15 : 34:34 


300 

400 

500 

600 

700 


A 

A 


A 


1 . 2 


3 ... 


R CUSMSTL 1 I 
CPF7726-**«*«***<'* f I 

COST 
NAME 
ADDR 
K COST 


END 


••• 4 ••• 5 ••• ••• 6 ••• 7 

UNIQUE 

PFILE(CUSMSTP) 

TEXTCLOGICAL FILE MASTER RECORD*) 


OF SOURCE 


DATE 


PAGE 
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Title (appears at top of each output page): 


Q The program number, release modification level, and date of CPF. 
Q The qualified object name. 

Q The date and time of this run. 

Q The page number in the listing. 


Prolog: 

Q The type of file and the parameter values specified (or defaults if not 
specified) on the create file command. 

Qj The name of the DOS processor. 

Source: 


Q The sequence numbers of lines (records) in the source. Comments are 
treated like any other specification line and are given sequence numbers. 

See the chapter on Source Files in the CPF Programmer's Guide for how 
sequence numbers are assigned. 

Q The source specifications. 

Q If an error is found during processing of the DDS and can be traced 

specifically to a source specification, the error message identifier and an 
asterisk indicating where the error is are printed immediately following 
the source specification line. An asterisk is also printed under the 
sequence number to indicate that the line contains an error message. 

For more information about DDS processing errors, see the section on 
Errors Encountered During DDS Processing in the chapter on Data Base 
in the CPF Programmer's Guide. 



Title I 5714SSI R03 


SEQNBR «.1 


Expanded 

Source 


DATA DESCRIPTION 
EXPANDED SOURCE 


CUSMSTL.SC217806 


08/07/01 15:43:17 


UNIQUE 

PFILE(CUSMSTP) TEXT(•LOGICAL FILE 
ASTER RECORD*1 
TEXT(*CUSTOMEft NUMBER 

•) COLHOG(*CUS* 
TOMER* 'NUMBER*! CHECK(MF) 

TEXT('CUSTOMER NAME 

*) COLHOGCCUS* 


DOR 20A TEXT('CUSTOMER ADORE 

TOMER ADDRESS*) 

UST 

END OF EXPANDED SOURCE 


•) COLHOGCCUS^ 


Title ( 5714S 

Messages "'"J 


5714SS1 R03 MOO 811204 


SEV NUMBER TEXT 


DATA DESCRIPTION 


CUSMSTL.SC217806 


7726 10 I Record name ts same as name of file bein^ created) 


08/07/81 15:43:17 


Message 

Summary 


{ TOTAL 1NF0(0- 

« CPF7301 00 Fi 


MESSAGE SUMMARY 

WARNING!10-19) ERR0R(20-29) SEVERE(30-99)j 


le CUSMSTL created in library SC217806* 
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Expanded Source: 


IQ Only the valid DOS. This list is what is actually in the file description. No 
comments or messages are printed. Default values and referenced values 
are printed for the valid DDS. 

QQ The length and the buffer (input or output) position of each field. 
Messages: 


Q This section contains a list of all messages (general messages and those 
already indicated in the source section) encountered during processing of 
the DDS. For each message, the message identifier, the severity, the 
number of times the message occurred, and the message text are listed. 


Message Summary: 

QQ The number of messages at each severity level. 
Q] The final completion message. 



DEBUGGING TEMPLATE 


A special template is available to aid you in interpreting the fields on the DDS 
compiler listing. Figure F-24 shows a reduced (DDS) Debugging Template, 
GX21-7717-0. 


Sequence 

Number 


M. 


y. 


| 14 | 15 | 16|17 18 | 

& 


Condition Name 


19I20I21I22I23I24I25I26I27I2 




Length 



7|48|49|50|5l|52|53|54|55l56l57|5a|59|6ol6l|62|63|64|65|66|67|68l69|7o|7l|72|73|74l75|76|77|78l79|80| 


b = And 
A = And 


Name Type —’ 

R = Record format name 
b = Field name 


R = Reference 


IT 


b= Defaults are assumed; 

A if blank for decimals 
S if decimals are specified 
without editing keyword 
Y if decimals are specified 
with editing keyword 


Data Type/Keyboard Shift 


Display 

Files 

only 


A = All characters - alpha shift 

S = Signed numeric 

X = Alpha only 

Y = Numeric only 

N = All characters - numeric shift 

I = Inhibit keyboard entry 

W = Katakana shift (for Japan only) 


b = Output only 
O. = Output only 
D' la I * ~ Input only 

; 8 = Both input and output 
H = Hidden 
f M = Message 


E)evice File Descriptions 


Frequently Used Keywords 


AUTO 

CAnn 

CFnn 

CHANGE 

CHECK 

CMP 

DFT 

DSPATR 

EDTCDE 

ERRMSG 


KEEP 

MDTOFF 

OVERLAY 

PRINT 

PROTECT 

PUTRETAIN 

REF 

REFFLD 

TEXT 

VALUES 



Figure F-24. IBM Data Description Specifications Debugging Template (reduced) 


Examples 
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UStNG SEU TO BROWSE THROUGH A COMPILER LISTING AND UPDATE 
SOURCE STATEMENTS 

When your compiler listing is on an ouput queue, you can use SEU to browse 
through (view) your listing. ~ 

The following shows the split-edit display available in SEU, which allows you 
to browse through your compiler listing at your work station: 


An error 
found 


Message*' 



SEU 

US M:1 

Mbr: CUSMSTL 


Scan: 


FMT Aif 

. 

>1 ... ... 2 ... ... 

3. 

4 ... ... 5 ... ... 6 ... ... 7 



HifififBEGimim OF DATAJfXifX 




0001«00 

A<e 





0002.00 

Aif 

SAMPLE LOGICAL FILE 

(CUSMSTL) 



0003.00 

A# 





0004.00 

A 



UNIQUE 


0005.00 

A 

R CUSMSTL 


PFILE(CUSMSTP) 

An * requests 

..,^^0006.00 

A 



TEXTC* LOGICAL FILE MASTER R 

a scan for 


A 

ACTNUM 



compilation 

0008.00 


NAME 



errors 

0009.00 

A 





0010.00 

A 

1^ ACT'I 




Browse MbrrSPOOLFILE W:1 


Post 


"Scan: 


500 

A 

R CUSMSTL 

CPF 7726 

PFILE(CUSMSTP) 

600 

A 


TEXT(•LOGICAL FILE 

700 

A 

ACTNUM 


800 

A 

NAME 


900 

A 

ADDR 


1000 

A 

K ACTNUM 



^ M END OF 
-Record name is same as name of file being created 


SOURCE ^ if ^ n 


^Source 

Statements 


► Compiler 
Listing 


While browsing through the listing, you can: 

• Scan for errors 

• Press the Help key to display second-level text for error messages 

• Correct the source statements that have errors 

For detailed information about browsing through a compiler listing, see the SEU 
Reference Manual. 
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Appendix G. Data Description Specifications Keyword and Value Abbreviations 


The following list contains all keyword and value abbreviations used in data description specifications. Each 
abbreviation is listed in alphabetical order, followed by its associated meaning. 


A 

after 

DFT 

default 

AB 

allow blanks 

DLT 

delete 

ABS 

absolute 

DSP 

display 

ACC 

access 

1 DTA 

data 

ALT 

alternate 

DUP 

duplicate 

ALW 

allow 

EDT 

edit 

ATR 

attribbtes 

END 

end 

AUTO 

automatic 

EQ 

equal 

B 

before 

1 

end of record (= end of field) 

BL 

blinking field 

ERR 

error 

BLANKS 

blanks 

FAIL 

fail 

BLINK 

blinking cursor 

FE 

field exit 

BLK 

blank 

FLD 

field 

CA 

command attention key 

FMT 

format 

CDE 

code 

GE 

greater than or equal to 

CF 

command function key 

GRP 

group 

CHG 

change 

GT 

greater than 

CHK 

check 

HDG 

heading 

CLR 

clear 

HI 

high intensity 

CLRL 

clear line 

ID 

identifier 

CLS 

class 

IND 

indicator 

CMD 

command 

INP 

input 

CMP 

comparison 

INZ 

initialize 

COL 

column 

1 LC 

lowercase 

COMP 

comparison 

LE 

less than or equal to 

CON 

constant 

LIFO 

last in first out 

CONCAT 

concatenate 

LIN 

line 

CS 

column separator 

LOG 

location 

CSR 

cursor 

LT 

less than 

CTL 

control 

MDT 

modified data tag 

DEV 

device 

ME 

mandatory enter 

DFN 

defined 

MF 

mandatory fill 


Data Description Specifications Keyword and Value Abbreviations G”1 



MSG 

message 

RNA 

record not active 

M10 

IBM Modulus 10 

ROL 

roll 

Mil 

IBM Modulus 11 

RQS 

request 

NBR 

number 

RTG 

routing 

ND 

nondisplay 

RTN 

return 

NE 

not equal to 

RZ 

right-adjust with zero fill 

NG 

not greater than 

SEQ 

sequence 

NL 

not less than 

SFL 

subfile 

NXT 

next 

SIZ 

size 

OF 

off 

SKIPA 

skip after 

OID 

operator identification 

SKIPB 

skip before 

OUT 

output 1 

SLNO 

starting line number 

OVR 

override 

SP 

select by light^pen 

P 

physical 

SPACEA 

space after 

PAG 

page 

SPACER 

space before 

PC 

position cursor 

TRNRND 

turn around 

PFILE 

physical file 

TXT 

text 

PGM 

program 

UL 

underline 

POS 

position 

USR 

user 

PR 

protect 

VAL 

values 

PRT 

print or printer 

VLD 

valid 

PTH 

path 

VN 

valid name 

Q 

queue 

WRD 

word 

RA 

record advance 

WRT 

write 

RAB 

right-adjust with blank fill 



RAZ 

right-adjust with zero fill 



RB 

right-adjust with blank fill 



RCD 

record 



RCV 

receive 



REF 

reference 



Rl 

reverse image 



RL 

right to left 



RLTB 

right to left, top to bottom 





Appendix H. Glossary 


This glossary is a subset of the System/38 glossary. 

The System/38 glossary defines terms that are used in 
the customer documentation for System/38. 

This glossary includes definitions developed by the 
American National Standards Institute (ANSI) and the 
International Organization for Standardization (ISO). This 
material is reproduced from the American National 
Dictionary for Information Processing, copyright 1977 by 
the Computer and Business Equipment Manufacturers 
Association. Copies of this dictionary may be purchased 
from the American National Standards Institute, 1430 
Broadway, New York, New York 10018. Definitions 
from this dictionary are identified by (ANSI) at the 
beginning of the definition. 

access path: The means by which CPF provides a 
logical organization to the data in a data base file so 
that the data can be processed by a program. See also 
arrival sequence access path and keyed sequence access 
path. 

acknowledgment character: In BSC, a transmission 
control character that is sent as a positive response to a 
data transmission. 

ACKO: in BSC, the even-numbered positive 
acknowledgment character. The ACKO character 
indicates that text was received without transmission 
errors. See acknowledgment character. 

ACK1: In BSC, the odd-numbered positive 
acknowledgment character. The ACK1 character 
indicates that text was received without transmission 
errors. See acknowledgment character. 

alphabetic character: (1) Any one of the letters A 
through Z (uppercase and lowercase) or one of the 
characters #, $, or @. (2) In COBOL, a character that is 
one of the 26 uppercase characters of the alphabet, or a 
space. 

alphameric character: Any one of the alphabetic 
characters, one of the digits 0 through 9, or the 
character_(underscore) as defined in CPF. 

alphanumeric character: In COBOL, any character in 
the computer's character set. 


alternate collating sequence: A collating sequence 
that differs from the normal collating sequence or that 
allows two or more characters to be considered equal. 
See collating sequence. 

AND relationship: The specification of conditioning 
indicators so that the operation is performed only when 
all conditions are met. 

application: (1) A particular data processing task, such 
as an inventory control application or a payroll 
application. (2) In IDU, specialized program created by 
IDU from user input. An application is later called by 
DFU or the query utility. 

application program: A program used to perform a 
particular data processing task such as inventory control 
or payroll. 

arrival sequence access path: An access path that is 
based on the order in which records are stored in a 
physical file. Contrast with keyed sequence access path. 

ascending key sequence: The arrangement of data in 
an order from the lowest value of the key field to the 
highest value of the key field. Contrast with descending 
key sequence. 

ascending sequence: The arrangement of data in an 
order from low to high based on the contents of a 
specific field or fields. Contrast with descending 
sequence. 

attribute: A characteristic; for example, attributes of a 
field include its length and data type, and attributes of a 
job include its user name and job date. 

attribute character: A character associated with a field 
in a display file that defines how the field is displayed 
(such as underlined, blinking, or intensified). 

authority: The right to access objects, resources, or 
functions. 

batch device: Any device that can read serial input or 
write serial output, or both, but cannot communicate 
interactively with the system. Examples of batch devices 
are card devices, printers, and diskette units. 
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batch job: A group of processing actions submitted as 
a predefined series of actions to be performed with little 
or no Interaction between the user and the system. 

batch processing: A method of executing a program or 
a series of programs in which one or more records (a 
batch) is processed with little or no interaction with the 
user or operator. Contrast with interactive processing. 

beginning attribute character: For a display file, the 
character that precedes the first position in a field and 
that defines the displayed field. 

binary: Relating to, being, or belonging to a numbering 
system with a base of 2. Valid digits are 0 and 1. 

binary format: Representation of a decimal value in 
which each field must be 2 or 4 bytes long. The sign (+ 
or -) is In the leftmost bit of the field, and the integer 
value is in the remaining bits of the field. Positive 
numbers have a 0 in the sign bit and are in true form. 
Negative numbers have a 1 in the sign bit and are in 
twos complement form. 

binary synchronous communications: A form of 
communications line control that uses transmission 
control characters to control the transfer of data over a 
communications line. Abbreviated BSC. Contrast with 
Synchronous Data Link Controi. 

browse: In SEU, to look at records in a source member 
or in a spooled output file by using the 
record-positioning operations, the scan operation, and 
the roll keys. 

browse member: The member displayed in the lower 
part of the split-edit display. Records from the browse 
member can be copied, but no changes can be made to 
records in the browse member. 

BSC: See binary synchronous communications. 

BSC file: A device file created by the user to support 
BSC. Contrast with communications file. 

buffer: A portion of main storage into which data is 
read or from which it is written. 

byte: A group of eight adjacent binary digits that 
represents one EBCDIC character. 

CANCEL: An SNA command used to cancel a partially 
transmitted RU chain in the network. 


card file: A device file created by the user to support a 
card device. 

CF key: See command function key. 

changed record: An active subfile record to which a 
put or update operation has been issued with the DDS 
keyword SFLNXTCHG in effect, or an active subfile 
record that has been changed by the work station user. 

character: Any letter, digit, or other symbol in the data 
character set that is part of the organization, control, or 
representation of data. 

character field: An area that is reserved for a particular 
unit of information and that can contain any of the 
characters in the data character set. Contrast with 
numeric field. 

character literal: A symbol, quantity, or constant in a 
source program that is itself data, instead of a reference 
to data. Contrast with numeric literal. 

character set: All the valid characters for a 
programming language or for a computer system. 

character string: (1) A string consisting of any of the 
256 EBCDIC characters that are used as a value. (2) 
(ANSI) In COBOL, a sequence of characters that form a 
COBOL word, a literal, a PICTURE character-string, or a 
comment-entry. 

CL: See control language. 

close: A data manipulation function that ends the 
connection between a file and a program. Contrast with 
open. 

collating sequence: The order each character holds in 
relation to other characters according to the bit 
structure. 

column: A character position horizontally within a print 
line. The columns are numbered from 1, by 1, starting 
at the leftmost character position of the print line and 
extending to the rightmost position of the print line. 

command: (1) A statement used to request a function 
of the system. A command consists of the command 
name, which identifies the requested function, and 
parameters. (2) In SNA, any field set in the transmission 
header (TH), request header (RH), and sometimes 
portions of a request unit that initiates an action or that 
begins a protocol. 
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command function key: At a work station, a keyboard 
key that is used with the command (CMD) function 
control key to request preassigned functions. At the 
system console, a keyboard key, called a CF key, that is 
used to request preassigned functions. 

comment: A word or statement in a program, 
command, or file that serves as documentation instead 
of as instructions. A comment is ignored by a compiler. 

communications file: A device file created by the user 
to support LU1 SDLC communications. Contrast with 
esc file. 

communications iine: The physical link (such as a wire 
or a telephone circuit) that connects one or more work 
stations to a communications control unit, or connects 
one control unit to another. Contrast with data link. 

compile: To translate a source program into an 
executable program (an object). 

compile time: The time during which a source program 
is translated by a compiler into an executable program. 

compiler listing: A printout that is produced by 
compiling a program or creating a file and that optionally 
includes, for example, a line-by-line source listing, a 
cross-reference list, diagnostic information, and, for 
programs, the description of externally described files. 

composite key: A key for a file or record format that is 
composed of more than one key field. 

concatenated field: Two or more fields from a physical 
file record format that have been combined to make one 
field in a logical file record format. 

condition name: For display files, a name used to 
control the selection of DDS keywords and display 
locations based on the screen size associated with the 
display file. 

conditioning: (1) In a file, the use of indicators to 
control when certain functions or operations are to be 
performed. For example, in a display file, indicators can 
select fields to be displayed. (2) In an RPG program, the 
use of indicators to control when certain functions or 
operations are to be done. For example, in an RPG 
program indicators can control calculation or output 
operations. 


constant: Data that has an unchanging, predefined 
value to be used in processing. A constant does not 
change during the execution of a program, but the 
contents of a field or variable can. See also literal. 

constant field: In an externally described display or 
printer file, an unnamed field that contains actual data 
that is passed to the display or printer .but is unknown 
to the program passing it. 

continuation lines: (1) Additional lines required to 
continue the coding of a CL command or a DDS 
keyword and its value. (2) In RPG, additional lines 
specified on the file description specifications to provide 
more information about the file being defined. 

control language: The set of all commands with which 
a user requests functions. Abbreviated CL. 

control language program: An executable object that 
is created from source consisting entirely of control 
language commands. 

Control Program Facility: The system support licensed 
program for System/38. It provides many functions that 
are fully integrated in the system such as work 
management, data base data management, job control, 
message handling, security, programming aids, and 
service. Abbreviated CPF. 

CPF: See Control Program Facility. 

create: (1) The function used to bring an object Into 
existence in the system. (2) To bring an object into 
existence in the system. 

cross-reference listing: The portion of the compiler 
listing that contains information on where files, fields, 
and indicators are defined, referenced, and modified in a 
program. 

currency symbol: A character such as the dollar sign 
($) used to Identify monetary values. 

cursor: A movable spot of light, resembling a bright 
underscore, that shows where the next character will 
appear on the work station screen when a key on the 
keyboard is pressed. 

data base: The collection of all data base files stored in 
the system. 
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data base file: An object that contains descriptions of 
how input data is to be presented to a program from 
internal storage and how output data is to be presented 
to internal storage from a program. See also physical 
file and logical file. 

data character set: The 256 EBCDIC characters. 

data communications: The transmission of data 
between systems and/or remote devices over a 
communications line. 

data communications file: In COBOL a generic term 
for a communications file or a BSC file. See also 
communications file and BSC file. 

data description specifications: A description of the 
user's data base or device files that is entered into the 
system using a fixed-form syntax. The description is 
then used to create files. Abbreviated DDS. 

data file: Any nonsource file. A data file is created by 
the specification of FILETYPE(*DATA) on a create file 
command. 

data file utility: The utility of the Interactive Data Base 
Utilities licensed program that is used to create, 
maintain, and display records in a data base file. 
Abbreviated DFU. 

data link: The communications lines, modems, control 
units, work stations, and other communications 
equipment used for the transmission of data between a 
receiving station and a transmitting station in a data 
network. Contrast with communications line. 

data stream: For BSC, ail data transmitted over a data 
link in a single read or write operation. 

data type: An attribute used for defining data as 
numeric or character. 

DDS: See data description specifications. 

default value: A value assumed when no value has 
been specified. 

definite response: In SNA, a value in the 
form-of-response-requested field of the request header 
(RH). The value directs the receiver of the request to 
return a response unconditionally, whether positive or 
negative to that request. Contrast with exception 
response. 


delay maintenance: A method of maintaining keyed 
access paths for data base files. This method does not 
update an access path when the file is closed, but it 
retains updates in a delayed form so that they can be 
quickly applied at the next open, avoiding a complete 
rebuild. Contrast with rebuild maintenance and immediate 
maintenance. 

delete: (1) To remove an object or a unit of data (such 
as character, a field, or a record). (2) The SEU operation 
in which existing records can be removed from a source 
member. 

descending key sequence: The arrangement of data in 
order from the highest value of the key field to the 
lowest value of the key field. Contrast with ascending 
key sequence. 

descending sequence: The arrangement of data in an 
order from high to low based on the contents of a 
specific field. Contrast with ascending sequence. 

DEVD: See device description. 

device description: An object that contains information 
describing a particular device that is attached to the 
system. The system-recognized identifier for the object 
type is *DEVD. Abbreviated DEVD. 

device file: An object that contains a description of 
how input data is to be presented to a program from an 
external device and/or how output data is to be 
presented to the external device from the program. 
External devices can be work stations, card devices, 
printers, diskette magazine drives, magazine tape drives, 
or a communications link. 

DFU: See data file utility. 

digit: Any of the numerals from 0 through 9. 

diskette drive: The mechanism used to seek, read, and 
write data on diskettes. See also diskette magazine 
drive. 

diskette file: A device file created by the user to 
support a diskette device. 

diskette magazine drive: A diskette drive that can hold 
two magazines, each containing 10 diskettes, plus 
individual diskettes in three separate slots. It is used to 
transfer information between system internal storage 
and removable diskettes. 
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display: A visual presentation of information on a work 
station screen, usually in a specific format. Display is 
often used as a shortened version of information 
display. 

display file: A device file created by the user to support 
a display work station or console. 

display screen: An electronic display tube, similar to a 
TV picture tube, used to display information entered or 
received at the system console or a work station. 

display station: An input/output device containing a 
display screen and an attached keyboard that lets a user 
send information to or receive information from the 
system. 

duplicate key value: The occurrence of the same value 
in a key field or in a composite key in more than one 
record in a file. 

edit: (1) To modify a numeric field to an external format 
by suppressing zeros and inserting commas, periods, 
currency symbols, the sign status, or other constant 
information. (2) The process of using SEU to key in new 
source records and update existing source records in a 
source member. 

edit code: A letter or number indicating what kind of 
editing should be done before a field is displayed or 
printed. 

edit description: An object that contains a description 
of a user-defined edit code. The system-recognized 
identifier for the object type is *EDTD. 

edit word: A user-defined word with a specific format 
that indicates how editing should be done. 

embedded blank: A blank that appears between 
characters. 

end-of-text character: In BSC, the transmission control 
character that is used to end a logical set of records 
that began with the start-of-text character. Abbreviated 
ETX. Contrast with end-of-transmission-block character. 

end-of-transmission character: In BSC, the 
transmission control character that is usually used to 
end transmission with the remote system. Abbreviated 
EOT. 


end-of-transmission-block character: In BSC, the 
transmission control character used to end a block of 
records. Abbreviated ETB. Contrast with end-of-text 
character. 

ending attribute character: For a display file, the 
attribute character following the last position in a field. 

ENQ: See enquiry character. 

enquiry character: in BSC, a transmission control 
character used to indicate control of transmission on a 
point-to-point channel and to indicate a request for a 
station to repeat its response. 

enter: To press the Enter/Rec Adv key (on a work 
station keyboard) or the Enter key (on the system 
console) or a command function key to transfer 
keyed-in information to the system for processing. See 
also key in. 

EOT: See end-of-transmission character. 

ETB: See end-of-transmission-biock character. 

ETX: See end-of-text character. 

exception response: In SNA, a value in the 
form-of-response-requested field of a request header. 
The value requests the receiver to return a response 
only if the request is unacceptable as received or cannot 
be processed; that is, only a negative response can be 
returned. Contrast with definite response. 

execution time: The time during which the instructions 
of a computer program are executed by a processing 
unit. 

external message queue: A message queue that is 
part of the job message queue and is used to send 
messages between an interactive job and the work 
station user. For batch jobs, messages sent to the 
external message queue only appear in the job log. 

externally described data: Data contained in a file for 
which the fields in the records are described to CPF, by 
using data description specifications, when the file is 
created. The field descriptions can be used by the 
program when the file is processed. Contrast with 
program-described data. 


Glossary H-5 



externally described file: A file for which the fields in 
the records are described to CPF, through data 
description specifications, when the file is created. The 
field descriptions can be used by the program when the 
file is processed. Contrast with program-described file. 

field: An area that is reserved and used for a particular 
item of information. 

field reference file: A physical file that contains no 
members and whose record format describes the fields 
used by a group of files. 

field selection: The function of using option indicators 
on fields in a display file to display different data on 
different output operations rather than defining a record 
format for each combination of fields. 

file: A generic term for the object type that refers to a 
data base file, a device file, or a set of related records 
treated as a unit. The system-recognized identifier for 
the object type is *FILE. 

file description: (1) The information contained in the 
file that describes the file and its contents. (2) In 
COBOL, an entry in the File Section of the Data Division 
that provides information about the identification and 
physical structure of a file. 

first-level message: The initial message that is 
presented to the user. The initial message contains 
general information or designates an error. Contrast 
with second-level message. 

fixed currency symbol: A currency symbol that 
appears in a specified position of an edited field. 
Contrast with floating currency symbol. 

floating currency symbol: A currency symbol that 
appears immediately to the left of the leftmost position 
in an edited field. Contrast with fixed currency symbol. 

fold: To continue data for a line on the following 
printed or displayed line. Contrast with truncate. 

function key: A keyboard key that is used to request a 
specific system function. See also command function 
key. 

get operation: An input operation that obtains a record 
from an input file and passes it to a program. 


help text: Information that is associated with an 
information display, a menu, or a prompt that explains 
options or values displayed. Help text is requested by 
pressing the Help key. 

hexadecimal: Pertaining to a numbering system with a 
base of 16. Valid numbers are the digits 0 through 9 
and the characters A through F, where A represents 10 
and F represents 15. 

hidden field: A field in a display file that is passed 
from and to the program but is not sent to the display. 

high-level language: A programming language that 
relieves the programmer from the rigors of machine level 
or assembler level programming; for example, RPG III 
and COBOL. Abbreviated HLL 

HLL: See high-level language. 

IDU: See Interactive Data Base Utilities. 

immediate maintenance: A method of maintaining 
keyed access paths for data base files. This method 
updates the access path whenever changes are made to 
the data in the access path. Contrast with rebuild 
maintenance and delay maintenance. 

inactive record: A subfile record that has not been 
added to a subfile by a put operation or that was 
initialized as inactive by the DDS keywords SFLINZ and 
SFLRNA. 

indicator: (1) A 2-character entry on a specification 
form that is used to test a field or record or to tell when 
certain operations are to be performed. (2) An internal 
switch used by a program to remember when a certain 
event occurs and what to do when the event occurs. 

initialize: To set to a starting position or value. 

inline data file: A file described by a //DATA 
command that is included as part of a job when the job 
is read from an input device by a reader program. 

input: Information (or data) to be processed. 

input-capable field: A field in a display file into which 
data can be entered. An input field is passed from the 
device to the program when the program reads the 
record containing that field. 
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input file: (1) A data base or device file that has been 
opened with the option to allow records to be read. (2) 
(ANSI) In COBOL, a file that is opened in the input 
mode. 

input stream: A group of records submitted to the 
system as batch input that contains CL commands for 
one or more jobs and/or the data records for one or 
more inline data files. 

inquiry: A request for information from a data file 
usually made against one record. 

integer: (1) Any of the natural numbers, the negatives 
of these numbers or zero. (2) In COBOL, a numeric data 
item or literal that does not include any character 
positions to the right of the decimal point. Where the 
term integer appears in formats, integer must be an 
unsigned numeric literal and must be nonzero unless the 
rules for that format explicitly state otherwise. 

interactive: Pertaining to a program or system that 
alternately accepts input and then responds. An 
interactive system is conversational; that is, a continuous 
dialog exists between the user and the system. 

Interactive Data Base Utilities: A System/38 licensed 
program that consists of DFU, SEU, query, and SDA. 
Abbreviated I DU. 

interactive job: A job in which the processing actions 
are performed in response to input provided by a work 
station user. During a job, a dialog exists between the 
user and the system. 

interactive processing: Pertaining to a program or 
procedure that alternately accepts input and then 
responds to the input. Contrast with batch processing. 

internal storage: All main and auxiliary storage in the 
system. 

job: A single, identifiable sequence of processing 
actions that represents a single use of the system. A 
job is the basic unit by which work is identified on the 
system. 

job date: The date associated with a job. The job date 
usually defaults to the system date. 

job description: An object that contains information 
defining the attributes of a job. The system-recognized 
identifier for the object type is *JOBD. 


job log: A record of requests submitted to the system 
by a job, the messages related to the requests, and the 
actions performed by the system on the job. The job log 
is maintained by CPF. 

job message queue: A message queue that is created 
for each job. A job message queue is used for receiving 
requests to be processed (such as commands) and for 
sending messages that result from processing the 
requests. A job message queue consists of arr external 
message queue and a set of program message queues. 
See also external message queue and program message 
queue. 

job name: The name of a job as identified to the 
system. For an interactive job, the job name is the name 
of the work station at which the job was initiated; for a 
batch job, the job name is specified in the command 
used to submit the job. Contrast with qualified job name. 

Julian date: A date format that contains the year in 
positions 1 and 2, and the day in positions 3 through 5. 
The day is represented as 1 through 366, right-adjusted, 
with zeros in the unused high-order positions. 

key field: A field in a record whose contents are used 
to sequence the records of a particular type within a file 
member. 

key in: The action of pressing keys on a keyboard to 
specify information that is to be processed. See also 
enter. 

keyed sequence: The order in which records appear in 
an access path. The access path is based on the 
contents of one or more key fields contained in the 
records. 

keyed sequence access path: An access path to a 
data base file that is ordered on the contents of key 
fields contained in the individual records. Contrast with 
arrival sequence access path. 

keyword: (1) A name that identifies a parameter. 
Keywords are used in CL commands and in DDS. (2) In 
RPG, a word whose use is essential to the meaning and 
structure of a statement in a programming language. 

left-adjust: To place an entry in a field or to move the 
contents of a field so that the leftmost character of the 
data is in the leftmost position of the field. 
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level checking: A function that compares the record 
format level identifiers of a file to be opened with the 
file description that is part of a compiled program to 
determine if the file record format has changed since 
the program was compiled. 

library: An object that serves as a directory to other 
objects. A library is used to group related objects and to 
find objects by name when they are used. The 
system-recognized identifier for the object type is *LIB. 

library list: An ordered list of library names used to 
find an object. The library list indicates which libraries 
are to be searched and the order in which they are to be 
searched. The system-recognized identifier is *LIBL. 
*LIBL specifies to the system that a job's current library 
list is to be used to find the object. 

line traffic: The number of transmissions, and the 
amount of data sent and received on a communications 
line. 

listing: A printout usually containing the input and 
output of the compilation of a program, the creation 
(compilation) of an object, or the execution of a 
program. See also compiler listing. 

literal: A character string whose value is given by the 
characters themselves. For example, the numeric literal 
7 has the value 7, and the character literal 'characters' 
has the value CHARACTERS. See also character literal, 
constant and numeric literal. 

local work station: A work station that is connected 
directly to System/38 without need for data 
transmission facilities. Contrast with remote work 
station. 

logical file: A description of how data is to be 
presented to or received from a program. This type of 
data base file contains no data, but it provides an 
ordering and format for one or more physical files. 
Contrast with physical file. 

logical file member: A logical grouping of data records 
in a logical file. See also member. 

magazine: A container that holds up to 10 diskettes 
and is inserted into a diskette magazine drive. 

MDT: See modified data tag. 


member: A description of a named subset of records in 
a physical or logical file. Each member conforms to the 
characteristics of the file and has its own access path. 

All I/O requests are directed to a specific member of a 
data base file. 

menu: A display in which a list of options is shown. 

message: A communication sent from one person or 
program to another person or program. 

message field: In a display file, an output field that is 
treated as a message. 

message file: An object that contains message 
descriptions. The system-recognized identifier for the 
object type is *MSGF. 

message identifier: A 7-character code that identifies 
a predefined message and is used to retrieve its 
message description from a message file. 

message reference key: A key assigned to every 
message on a message queue. This key is used to 
remove a message from a message queue, to receive a 
message, and to reply to a message. 

modified data tag: An indicator, associated with each 
input or output/input field in a displayed record, that is 
set on when data is keyed into the field. The modified 
data tag is maintained by the display device and can be 
used by the program using the file. Abbreviated MDT. 

modulus 10 checking/modulus 11 checking: A 
technique for validity checking that involves the 
association of digits with data. It is used in entering or 
updating fields in a data record. 

negative response: In SNA, a response indicating that 
a request did not arrive successfully or was not 
processed successfully by the receiver. Contrast with 
positive response. See also exception response. 

numeric character: Any one of the digits 0 through 9. 

numeric field: An area that is reserved for a particular 
unit of information and that can contain only the 
numeric digits 0 through 9. Contrast with character field. 

numeric literal: The actual numeric value to be used in 
processing, instead of the name of a field containing the 
data. A numeric literal can contain any of the numeric 
digits 0 through 9, a sign (plus or minus), and a decimal 
point. Contrast with character literal. 
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object: A named unit that consists of a set of attributes 
(that describe the object) and, in some cases, data. An 
object is anything that exists in and occupies space in 
storage and on which operations can be performed. 
Some examples of objects are programs, files, and 
libraries. 

object name: The name of an object. Contrast with 
qualified object name. 

ODP: See open data path. 

omit function: A CPF function that determines which 
records from a physical file are to be omitted from a 
logical file's access path. Contrast with select function. 

open: The function that connects a file to a program for 
processing. Contrast with close. 

open data path: The path through which all I/O 
operations for the file are performed. Abbreviated ODP. 

operational rights: The authority to use an object and 
to look at its description. 

option indicator: A 1 -character field that is passed 
with an output data record from a program to CPF and 
that is used to control the output function, such as 
controlling which fields in the record are displayed. 

output: Data transferred from storage to an output 
device. 

output field: A field in a display or printer file in which 
data can be modified by the program and sent to the 
display or printer during an output operation. 

output file: (1) A data base or device file that has been 
opened with the option to allow records to be written. 

(2) In COBOL, a file that is opened in either output 
mode or extend mode. 

output/input field- A field in a display file that is used 
for both output and input operations. 

overflow: The condition that occurs when the last line 
specified as the overflow line to be printed on a page 
has been passed. 

overflow condition: (1) The condition that occurs when 
the overflow line on a page has been printed or passed. 
(2) In COBOU a condition that occurs when a portion of 
the result of an operation exceeds the capacity of the 
intended unit of storage. 


overflow handling: The method of advancing from one 
printer page to the next. 

overflow indicator: An indicator that signals when the 
overflow line on a page has been printed or passed. 

The indicator can be used to specify which lines are to 
be printed on the next page. 

overflow line: The line specified as the last line to be 
printed on a page. 

overflow page: The new page created when overflow 
occurs. 

overlapping fields: Fields in the same display or printer 
record that are defined to overlap each other; that is, to 
occupy the same positions on the display or the page. 
Option indicators can be used to select which of the 
overlapping fields is to be displayed or printed. 

packed decimal format: Representation of a decimal 
value in which each byte within a field represents two 
numeric digits except the rightmost byte, which contains 
one digit in bits 0 through 3 and the sign in bits 4 
through 7. For all other bytes, bits 0 through 3 
represent one digit; bits 4 through 7 represent one digit. 
For example, the decimal value +123 is represented as 
(DOOl 0010 0011 1111. Contrast with zoned decimal 
format. 

packed field: A field that contains data in the packed 
decimal format. 

packed key: A key in the packed decimal format. 

page: (1) A 512-byte block of information that can be 
transferred between auxiliary storage and main storage. 
(2) Each group of records in a subfile that are displayed 
concurrently. (3) One printer form. 

parameter: (1) Data passed to or received from another 
program. (2) in CPF, an argument that identifies an 
individual value or group of values to be used by a 
command to tailor a function requested through the 
command. 

physical file: A description of how data is to be 
presented to or received from a program and how data 
is actually stored in the data base. A physical file 
contains one record format and one or more members. 
Contrast with logical file. 

physical file member: A subset of the data records in 
a physical file. See also member. 
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positive response: In SNA, a response indicating that 
a request arrived and was successfully received and 
processed. Contrast with negative response. See also 
definite response. 

printer file: A device file created by the user to support 
a printer device. 

printer/display layout: A coding form on which the 
programmer can design the format for a printed report 
or a display. 

program: An object that contains a set of instructions 
that tell a computer where to get input, how to process 
it, and where to put the results. A program is created as 
a result of a compilation. The system-recognized 
identifier for the object type Is * PGM. 

program-described data: Data contained in a file for 
which the fields in the records are described in the 
program that processes the file. Contrast with externaily 
described data. 

program-described file: A file for which the fields in 
the records are described only in the program that 
processes the file. To CPF, the record is viewed as a 
character string. Contrast with externaiiy described fiie. 

program message queue: A message queue used to 
hold messages that are sent between program 
invocations of a routing step. The program message 
queue is part of the job message queue. 

prompt: A displayed request for information or user 
action. The user must respond to allow the program to 
proceed. 

protected field: A field in a display file in which data 
cannot be keyed, changed, or erased. 

put operation: An output operation that writes a record 
to an output file. 

put-get operation: A combination of an output 
operation (put) followed by an input operation (get) to 
the same record format. 

qualified object name: An object name and the name 
of the library containing the object. Contrast with object 
name. 


query: (1) A utility thdt is part of the Interactive Data 
Base Utilities licensed program. (2) A request to extract, 
from a file, one or more records based upon some 
combination of data. 

queue: A line or list formed by items in the system 
waiting for service; for example, work to be performed 
or messages to be displayed. 

reader: A program that reads jobs from an input device 
or a data base file and places them on a job queue. 

rebuild maintenance: A method of maintaining keyed 
access paths for data base files. This method updates 
the access path only while the file is open, not when the 
file is closed; the access path is rebuilt when the file is 
opened. Contrast with immediate maintenance and delay 
maintenance. 

record: (1) An ordered set of fields that make up a 
single occurrence of the basic unit of data transferred 
between a file and a program. (2) In COBOL, a set of 
one or more related data items that are grouped for 
processing. Records can be defined for an input/output 
device or for internal processing. 

record format: The definition of how data is structured 
in the records contained in a file. The definition includes 
the record name, field names, and field descriptions 
(such as length and data type). The record formats used 
in a file are contained in the file's description. 

record format level identifier: An identifier placed on 
a record format that uniquely identifies the record 
description. See also level checking. 

relational operator: (1) In CL, an operator that can be 
used in an arithmetic, character, or logical relation to 
indicate the comparison to be performed between the 
terms in the relation. The relational operators are *EQ or 
= (equal to), *GT or > (greater than), *LT or < (less 
than), *GE or >= (greater than or equal to), *LE or <= 
(less than or equal to), *NE or (not equal to), *NG or 
”» (not greater than), *NL or “« (not less than). (2) In 
COBOL, a reserved word, a relation character, a group 
of consecutive reserved words, or a group of 
consecutive reserved words and relation characters used 
to construct a relation condition. 

remote work station: A work station whose 
connection to the processing system uses modems and 
common carrier or private data transmission facilities. 
Contrast with local work station. 
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request: (1) A CL command, the selection of an option 
on a menu, or the entering of data that instructs the 
system to perform a function. A CL command can be 
entered interactively or in a batch job. A request is 
identified as RQS on the job log. (2) In SNA, a request 
unit that asks for a particular action or protocol; or a 
message unit that acknowledges receipt of a request. A 
request consists of a request unit, a segment of a 
request unit, or both. 

response: In SNA, a message unit that acknowledges 
receipt of a request; a response consists of a response 
header, a response unit, or both. 

response indicator: A 1 -character field passed with an 
input record from CPF to a program to provide 
information about the data record or actions taken by 
the work station user. 

reverse-interrupt character: In BSC, a transmission 
control character that is sent as a request by the 
receiving station to the sending station to stop 
transmitting in order to receive a message. Abbreviated 
RVI. 

right-adjust: To place an entry in a field or to move the 
contents of a field so that the rightmost character of the 
data is in the rightmost position of the field. 

routing data: A character string that CPF compares 
with character strings in the subsystem description 
routing entries to select the routing entry that is to be 
used to initiate a routing step. Routing data can be 
provided by a work station user, specified in a 
command, or provided through the job description for 
the job. 

routing entry: An entry in a subsystem description that 
specifies the program to be invoked to control a routing 
step that executes in the subsystem. 

routing step: The processing performed as a result of 
invoking a program specified in a routing entry. 

RSP: See response. 

RVI: See reverse-interrupt character. 

screen design aid: The utility of the Interactive Data 
Base Utilities licensed program that is used to 
interactively design, create, and maintain display record 
formats and menus. Abbreviated SDA. 

SDA: See screen design aid. 


second-level message: A message that provides 
additional information to that already provided in a 
first-level message. See also second-level message 
display. 

second-level message display: A display containing 
the second-level message text (if any) and additional 
message information. This display is obtained by 
pressing the Help key while a first-level message is 
displayed. 

security; The control of access to, or use of, data or 
functions. 

select function: A CPF function that determines which 
records from a physical file are to be selected for a 
logical file's access path. Contrast with omit function. 

select/omit field: A field in a logical file record format 
whose value is compared with a constant, the contents 
of another field, a range of values, or a list of values to 
determine if a record is to be omitted from the access 
path of the logical file or selected for use by the logical 
file. See also omit function and select function. 

self-check digit: The rightmost digit of a self-check 
field. 

self-check field: A field such as an account number, 
consisting of a base number and a self-check digit. For 
data entry applications, the operator-entered self-check 
digit is compared with the self-check digit computed by 
the system. 

sequence number: The number of a record that 
identifies the record within the source member. 

sequential file: A file in which records are processed in 
the order that they are stored in the file. 

SEU: See source entry utility. 

severity code: A code that indicates how important a 
message is. The higher the code, the more serious the 
condition is. 

shared access path: An access path used by more 
than one file to provide access to data common to the 
files. 

shared file: A file whose open data path can be shared 
between two or more programs executing in the same 
routing step. 
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shared record format: A record format that is used in 
more than one externally described file. 

SIGNAL: An SNA command used to request a break in 
data flow. 

skip: To cause the printer to move the paper to a 
specified line before or after it prints a line. 

SNA: See Systems Network Architecture. 

source entry utility: The utility of the Interactive Data 
Base Utilities licensed program that is used to create 
and change source members. Abbreviated SEU. 

source file: A file created by the specification of 
FILETYPE(*SRC). A source file can contain source 
statements for such items as high-level language 
programs and data description specifications. 

source listing: A portion of a compiler listing that 
contains source statements and diagnostics. See also 
compiler listing. 

source member: A member of a data base source file 
that contains source statements such as RPG, COBOL, 
or DDS specifications. See also member. 

source statement: A statement written in symbols of a 
programming language. For example, RPG, COBOL, or 
DDS specifications are source statements. 

space: To cause the printer to move the paper a 
specified number of lines before or after it prints a line. 

special character: (1) A character other than a digit, a 
letter, or #, $, or @. For example, +, and % are 
special characters. (2) In COBOL, a character that is 
neither numeric nor alphabetic. Special characters in 
COBOL include: + -*/ = $,.")(;<> 

spooled file: A generic term for three types of files: a 
device file that provides access to an inline data file or 
that creates a spooled output file, an inline data file, or a 
spooled output file. 

spooled input file: See inline data file. 

spooled output file: A device file that causes output 
data to be saved for later processing by a writer. 


start-of-text character: In BSC, a transmission control 
character that is used to begin a logical set of records 
that will be ended by the end-of-text character. 
Abbreviated STX. 

STX: See start-of-text character. 

subfile: A group of records of the same record format 
that can be displayed concurrently at a work station. 

The system sends the entire group of records to the 
work station in a single operation and receives the group 
in another operation. 

subfile control record format: One of two record 
formats required to define a subfile in DDS. The subfile 
control record format describes the size of the subfile 
and the size of the subfile page, and is used by the 
program to write the subfile to and read the subfile from 
the display. See also subfile record format. 

subfile record format: One of two record formats 
required to define a subfile in DDS. The subfile record 
format defines the fields in a subfile record and is used 
by the program to perform input, output, and update 
operations to the subfile. 

Synchronous Data Link Control: A discipline 
conforming to subsets of the Advanced Data 
Communication Control Procedures (ADCCP) of the 
American National Standards Institute (ANSI) and 
High-level Data Link Control (HDLC) of the International 
Standards Organization (ISO), for managing 
synchronous, code-transparent, serial-by-bit information 
transfer over a link connection. Transmission exchanges 
may be duplex or half-duplex over switched or 
nonswitched links. The configuration of the link 
connection may be point-to-point, multipoint, or loop. 
Abbreviated SDLC. 

syntax checking: A function of the command analyzer, 
a compiler, or SEU that checks single statements for 
violations of the rules governing the structure of the 
statement. 

system console: The keyboard and display screen on 
the system unit that serve as a work station for 
communicating with and controlling the system. See 
also work station. 

system date: The date established for the system 
when it is started. 
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system operator: The person who operates the system 
and looks after the peripheral equipment necessary to 
initiate computer runs or finalize the computer output in 
the form of completed reports and documents. 

system value: A value that contains control information 
for the operation of certain parts of the system. A user 
can change the system default value to tailor the system 
to his working environment. System date and library list 
are examples of system values. 

Systems Network Architecture: The description of 
the logical structure, formats, protocols, and operational 
sequences for transmitting information units through and 
controlling' the configuration and operation of Systems 
Network Architecture networks. Abbreviated SNA. 

Note: The layered structure of SNA allows the ultimate 
origins and destinations of information (that is, the end 
users) to be independent of, and unaffected by, the 
specific SNA network services and facilities used for 
information exchange. 

tape file: A device file created by the user to support a 
tape device. 

truncate: To drop data that cannot be printed or 
displayed in the line width specified or available. 

Contrast with fold. 

update operation: An I/O operation that modifies the 
information in a file. 

user-defined edit code: A number (5 through 9) 
indicating that editing should be done on a numeric 
output field according to a pattern predefined to CPF. 
User-defined edit codes can take the place of edit 
words, so that repetitive coding of the same edit word 
is not necessary. 

user profile: An object that contains a description of a 
particular user or group of users. A user profile contains 
a list of authorizations to objects and functions. The 
system-recognized identifier for the object type is 
•USRPRF. 

validity checker: A user-written program that tests 
commands for errors in the parameter values. Validity 
checking is done in addition to the checking done by the 
command analyzer. 


validity checking: Operations performed against a field 
value to ensure that the field contains appropriate data. 
Checking can be done on a single field (for example, the 
field must be plus) or on multiple fields (for example, if 
FLDA contains a 1, FLDB can contain only a 2 or 3). 

variable: A named modifiable value. The value can be 
accessed or modified by referring to the name of the 
variable. 

vertically displayed records: Subfile records that are 
grouped ih a display so that more than one record of 
the same record format is displayed concurrently. Each 
record begins in the first position of a line and occupies 
one or more adjoining lines. 

work station: A device that lets a person transmit 
information to or receive information from a computer as 
needed to perform his job. 

work station user: A person who uses a work station 
to communicate with System/38. 

zoned decimal format: Representation of a decimal 
value by 1 byte per digit. Bits 0 through 3 of the 
rightmost byte represent the sign; bits 0 through 3 of all 
other bytes represent the zone portion; bits 4 through 7 
of all bytes represent the numeric portion. For example, 
in zoned decimal format, the decimal value of +123 is 
represented as 1111 0001 1111 0010 1111 0011. 
Contrast with packed decimal format. 

zoned field: A field that contains data in the zoned 
decimal format. 


Glossary 
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- (see minus sign) 1-23 
(see plus sign) 

I (OR bar used in coding syntax) 1-23 
& (see ampersand) 

* (see asterisk) 

♦ALL (see ERASEINP; MDTOFF) 

♦DS1, ♦DS2, *DS3 (see also DSPSIZ) 4-5 
♦ERASE (see UNLOCK) 

♦MDTOFF (see UNLOCK) 

♦MDTON (see ERASEINP) 

♦NO (see CLRL) 

♦NOLOC 4-89 

♦NONE, key field specification 3-12 
♦SRC, as parameter value for REFFLD 
for communications files and BSC 
files 6-17 

for display files 4-147 
for physical files 2-30 
for printer files 5-32 
♦UNPR (see MDTOFF) 

♦VAR (see SLNO) 

[ ] (brackets used in coding syntax) 1 -23 


A 

in position 35 (Data Type) 

(see also A, in position 35 (Keyboard 
Shift) 

for communications files and BSC 
files 6-10 
for logical files 3-24 
for physical files 2-10 
for printer files 5-9 
in position 35 (Keyboard Shift) 
for display files 4-17 
In position 6 (Form Type) 

for communications files and BSC 
files 6-3 

for display files 4-3 
for logical files 3-5 
for physical files 2-2 
for printer files 5-3 
AB (allow blanks) 4-53 
abbreviations G-1 
ABSVAL 

(see also DIGIT; SIGNED; ZONE) 
coding example 

for logical files 3-30 
for physical files 2-15 


ABSVAL (continued) 
keyword description 
for logical files 3-29 
for physical files 2-14 
access path 

(see also key field name; UNIQUE) 
definition H-1 
description 1 - 5 
establishing 

for logical files 3-3 
for physical files 2-6 
keywords 3-10 

sharing (ACCPTH keyword) 3-22 
types of 1 -5 

with select/omit specifications 3-20 
with UNIQUE 

for logical files 3-52 
for physical files 2-34 
ACCPTH 

coding example 3-30 
keyword description 3-30 
with PFILE 3-31, 3-46 
acknowledgment character, definition 
of H-1 

ACKO, definition of H-1 
ACK1, definition of H-1 
Add Logical File Member (ADDLFM) command 
with keyed sequence access path 3-9 
with PFILE 3-46 

ADDLFM (Add Logical File Member) command 
with keyed sequence access path 3-9 
with PFILE 3-46 

affirmative Put override (see PUTOVR) 

AID (Attention Identifier) byte 4-110 
ALARM 

coding example 4-36 
keyword description 4-36 
algorithm, self-check (see Modulus 10 and 
1W 
ALL 

coding example 3-32 
keyword description 3-32 
X with select/omit field name 3-20 
allow blanks 4-53 
allow write 6-13 

alphabetic character, definition of H-1 
alphabetic data type (see Data Type, A 
(character)) 

Alphabetic Only 4-17 

alphameric character, definition of H-1 

Alphameric Shift 4-17 

alphanumeric character, definition of H-1 



alternate collating sequence 
definition H-1 
for logical files 3-33 
for physical files 2-16 
with key position attribute 
checking 3-10 
alternate collating table 
for logical files 3-33 
for physical files 2-16 
ALTSEQ 

(see also NO ALTSEQ; records, retrieval 
of) 

coding example 

for logical files 3-33 
for physical files 2-16 
keyword description 
for logical files 3-33 
for physical files 2-16 
with key position attribute 
checking 3-10 
ALWWRT 

coding example 6-13 
keyword description 6-13 
ampersand 
in edit word 

for display files 4-103 
for logical files 3-42 
for physical files 2-23 
for printer files 5-23 
And/Or/Comment (position 7) 

And (see AND, logical) 

Comment (see comment) 

Or (see OR, logical) 

AND relationship, definition of H-1 
AND, logical (A or blank in position 7) 

(see also Conditioning) 
for communications files and BSC 
files 6-4 

for display files 4-3 
for printer files 5-4 
apostrophes 

in column headings (COLHDG keyword) 
for logical files 3-35 
for physical files 2-17 
in DFT keyword 

for display files 4-50 
for printer files 5-16 
In edit word (EDTWRD keyword) 
for display files 4-78 
for logical files 3-42 
for physical files 2-23 
for printer files 5-21 
in TEXT keyword 

for communications files and BSC 
files 6-25 

for display files 4-202 
for logical files 3-51 
for physical files 2-32 
for printer files 5-37 
syntax rules for 1 -22 


apostrophes (continued) 

within quoted parameter values 1 -22 
application program, definition of H-1 
application, definition of H-1 
arrival sequence access path 
(see also access path) 
as default 

for logical files 3-3 
for physical files 2-6 
definition H-1 
description 1-5 

ascending key sequence, definition of H-1 
ascending sequence 
(see also DESCEND) 
definition of H-1 
ASSUME 

coding example 4-37 
keyword description 4-37 
asterisk 

in edit code (EDTCDE keyword) 
for display files 4-98 
for logical files 3-41 
for physical files 2-21 
for printer files 5-20 
in edit word (EDTWRD keyword) 
for display files 4-100 
for logical files 3-43 
for physical files 2-23 
for printer files 5-23 
in position 7 (Comment) 

for communications files and BSC 
files 6-3 

for display files 4-3 
for logical files 3-5 
for physical files 2-3 
for printer files 5-3 
with SFLPGMQ 4-188 
asterisk fill 

for display files 4-100 
for logical files 3-41 
for physical files 2-22 
for printer files 5-20 
asterisk protection 

for display files 4-103 
for logical files 3-43 
for physical files 2-24 
for printer files 5-23 
Attention (CA) key 4-43 
attribute character 

beginning 4-15, 4-15, 4-31 
definition H-1 
ending 4-15, 4-16, 4-32 
attribute checking (of key position) 3-11 
attribute, definition of H-1 
authority, definition of H-1 
AUTO (see CHECK, as keyboard control 
keyword) 

automatic data functions (see keyboard 
control) 
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B 

in position 35 (see Data Type, B 
(binary)) 

in position 38 (see Usage (position 38)) 
batch device, definition of H-1 
batch job, definition of H-2 
batch processing 

creating files 1-14,1-15 
definition of H-1 
entering DDS source 1-14 
beginning attribute character 
definition H-2 
description 4-15, 4-16, 4-31 
binary data (see Data Type, B (binary)) 
binary format, definition of H-2 
binary synchronous communications, 
definition of H-2 
binary, definition of H-2 
BL (blink) 4-82 
blank 

(see also defaults) 
embedded 

definition H-2 
in DDS syntax 1-22 
in Data Description Specifications form 
(see defaults) 
in edit word 

for display files 4-103 
for logical files 3-42 
for physical files 2-23 
for printer files 5-23 
BLANKS 

(see also allow blanks) 
coding example 4-40 
keyword description 4-39 
BLINK 

coding example 4-41 
keyword description 4-41 
blinking cursor (BLINK) 4-41 
blinking field (DSPATR(BL)) 4-82 
BLKFOLD 

coding example 

for display files 4-42 
for printer files 5-14 
keyword description 

for display files 4-38 
for printer files 5-14 
with FOLD(*YES) parameter 5-12 
with INZRCD 4-119 
BLOCKCUSER) 

with ENDGRP keyword 6-14 
with RCVENDGRP keyword 6-17 
browse member, definition of H-2 
browse, definition of H-2 
BS (AID byte) 4-153 
BSC file 

coding examples F-14, 6-2 
definition H-2 
keyword entries 6-12 
keyword summary E-1 


BSC file (continued) 

positional entries 6-3 
valid keywords 6-13 
buffer, definition of H-2 
bytes 

definition H-2 
maximum number per record 
for logical files 3-22 
for physical files 2-9 
occupied by a field (see length, 
specification of) 


CA key (see CAnn 
CANCEL, definition of H-2 
CAnn 

(see also VLDCMDKEY) 
coding example 4-46 
keyword description 4-43 
card files 

DDS not valid for 1-1, 1-8 
definition H-2 
card reader/punch 1-8 
CF key 

(see also CFnn) 4-47 
definition H-2 
CFnn 

(see also VLDCMDKEY) 
coding example 4-49 
keyword description 4-47 
CHANGE 

coding example 4-51 
keyword description 4-50 
Change BSC File (CHGBSCF) 
command 6-14, 6-17 
Change Device Description (CHGDEVD) 
command 4-134 
Change Printer File (CHGPRTF) 
command 5-12 

changed record, definition of H-2 
character field, definition of H-2 
character literal 
definition H-2 
syntax rules for 1 -22, 1 -23 
character set 

character string, definition of H-2 
character, definition of H-2 
CHECK 

as cursor control keyword 4-63 
as keyboard control keyword 
for display files 4-59 
for logical files 3-34 
for physical files 2-17 
as validity checking keyword 
for display files 4-52 
for logical files 3-34 
for physical files 2-17 



CHECK (continued) 
coding examples 

cursor control 4-64 
keyboard control 4-60 
validity checking 4-54, 4-58 
CHGDEVD (Change Device Description) 
command 4-134 
CHGINPDFT 

coding example 4-66 
keyword description 4-66 
CHGPRTF (Change Printer File) 
command 5-12 
CL (see control language) 

CLEAR 

(see also VLDCMDKEY) 
coding example 4-67 
keyword description 4-67 
Clear key 4-67 
close 

close, definition of H-2 
with KEEP 4-120 
CLRL 

coding example 4-69 
keyword description 4-68 
CMP (see COMP) 

COBOL, sample Data Division F-64 
coding examples (see also syntax, coding 
examples) 

communications file or BSC file F-60, 
6-2 

display file 
menu F-12 

prompt with subfile F-17 
subfiles F-17 
field reference file F-6 
logical file F-10, F-11, 3-4 
physical file F-8, F-9, 2-2 
printer file F-57, 5-2 
COLHDG 

as default for TEXT 2-32 
coding example 

for logical files 3-35 
for physical files 2-18 
keyword description 
for logical files 3-35 
for physical files 2-18 
collating sequence 

(see also CAnn; CFnn; alternate collating 
sequence) 
alternate 

for logical files 3-33 
for physcial files 2-16 
definition H-5 
column heading (see COLHDG) 
column separator 4-82 
column, definition of H-2 
comma 

in edit code output 

for display files 4-99 
for printer files 5-21 


comma (continued) 
in edit word 

for display files 4-104 
for logical files 3-43 
for physical files 2-23 
for printer files 5-21 
command attention key 

(see also CAnn; CLEAR; HELP; HOME; PRINT; 

SFLDROP; SFLENTER; VLDCMDKEY) 
when valid 4-45 
command function key 

(see also CFnn; ROLLDOWN; ROLLUP; 
SFLDROP; SFLENTER; 

VLDCMDKEY) 
definition H-3 
when valid 4-45 

command key (see command attention key and 
command function key) 
command, definition of H-2 
comment 

definition H-3 

for communications files or BSC 
files 6-3 

for display files 4-3 
for logical files 3-5 
for physical files 2-3 
for printer files 5-3 
communications device 1 -8 
communications files 

coding examples F-60, 6-2 
definition H-3 
keyword entries 6-12 
keyword summary E-1 
positional entries 6-3 
valid keywords 6-13 
communications line, definition of H-3 
COMP 

as select/omit level keyword 
for logical files 3-35 
as validity checking keyword 
for display files 4-70 
for logical files 3-35 
for physical files 2-17 
coding example 

for display files 4-71 
for logical files 3-35 
keyword description 

for display files 4-70 
for logical files 3-35 
compare (see COMP) 
compile time, definition of H-3 
compile, definition of H-3 
compiler listings 
definition H-3 
showing *NOLOC 4-90 
showing effect of screen size on field 
location 4-94 

with description of its parts F-65 
compiler, definition of H-3 
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composite key 
definition H-3 
description 

for logical files 3-9 
for physical files 2-6 
CONCAT 

coding example 3-38 
keyword description 3-37 
concatenated field, definition of H-3 
concatenation 3-24, 3-37 
condition name 

(see screen size condition name) 
definition of H-3 
Conditioning (positions 7 through 16) 
definition H-3 
description 

for display files 4-3 
for printer files 5-3 
screen size condition names (see also 
DSPSIZ) 4-5 

console (see system console) 
constant field 
definition H-3 
description 

in display files 4-12 
in printer files 5-6 
with DATE 


for display files 

4-74 

for printer files 

5-15 

with DFT 

for display files 

4-75 

for printer files 

5-16 

with TIME 

for display files 

4-203 

for printer files 

5-38 

constant, definition of 

H-3 


continuation 1-23 

continuation lines, definition of H-3 

control language 

create file command 1-15 
definition H-3 

control language program, definition 
of H-3 

Control Program Facility, definition 
of H-3 

conversion of data type 

from data base file to display 
file 4-17 
CPF edit codes 

for display files 4-98 
for logical files 3-41 
for physical files 2-21 
for printer files 5-18 
CPF support for DDS 1-2 
CPI parameter 5-10 
CR (credit) (see minus sign, in edit word) 
Create BSC File (CRTBSCF) command 6-7 
Create Communications File (CRTCMNF) 
command 6-7 


Create Device Description (CRTDEVD) command 
with PRINT keyword 4-134 
Create Display File (CRTDSPF) command 
validity of Location entries 4-31 
Create Edit Description (CRTEDTD) 
command 5-20 
create file commands 
DDS as input to 1 -8 
use of 1 -9, 1 -15 
Create Logical File (CRTLF) command 

with MAINT(*IMMED) parameter value 3-52 
with UNIQUE 3-52 
Create Physical File (CRTPF) command 

with MAINT(*IMMED) parameter value 2-34 
with MBR(*NONE) parameter value 1-5 
with UNIQUE 2-34 
Create Printer File (CRTPRTF) command 
output shows buffer locations 5-10 
with FOLD(*YES) parameter 5-12 
Create Table (CRTTBL) command 
with ALTSEQ 

for logical files 3-33 
for physical files 2-16 
create, definition of H-3 
creating files 1-15 
cross-reference listing, definition 
of H-3 

CRTBSCF (Create BSC File) command 6-7 
CRTCMNF (Create Communications File) 
command 6-7 

CRTDEVD (Create Device Description) command 
with PRINT keyword 4-134 
CRTDSPF (Create Display File) command 
validity of Location entries 4-31 
CRTEDTD (Create Edit Description) 
command 5-20 

CRTLF (Create Logical File) command 

with MAINT(*IMMED) parameter value 3-52 
with UNIQUE 3-52 
CRTPF (Create Physical File) command 

with MAINT(*IMMED) parameter value 2-34 
with MBR (*NONE) parameter value 1-5 
with UNIQUE 2-34 
CRTPRTF (Create Printer File) command 
output shows buffer locations 5-10 
with FOLD(*YES) parameter 5-12 
CRTTBL (Create Table) command 
with ALTSEQ 

for logical files 3-33 
for physical files 2-16 
CS (column separator) (see DSPATR) 

CSRLOC 

coding example 4-73 
keyword description 4-72 
currency symbol 
definition H-3 

fixed (see fixed currency symbol) 
floating (see floating currency symbol) 
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currency symbol (continued) 
in edit codes 

for display files 4-100 
for logical files 3-42 
for physical files 2-22 
for printer files 5-20 
in edit word 

for display files 4-104 
for logical files 3-42 
for physical files 2-24 
for printer files 5-23 

cursor 

address 4-149 
blinking 4-82 

control (see cursor, positioning) 

definition H-3 

positioning 

with CHECK(RL) or CHECK(RLTB) 4-63 
with column separator 4-82 
with CSRLOC keyword 4-72 
with DSPATR(PC) 4-82 
with HOME 4-116 
with SFLRCDNBR 4-189 
cursor control code 4-63 
CURSOR parameter value, with SFLRCDNBR 
keyword 4-189 
Customer Review example F-17 


data base data management 1 -2 
data base files 

coding characteristics 1-5 
definition H-4 
description 1 -3 
logical (see logical files) 
physical (see physical files) 
data base, definition of H-4 
data character set, definition of H-4 
data communications 

(see also communications file) 
definition H-4 

data communications file, definition 
of H-4 

data description specifications (DOS) 
coding examples (see coding examples) 
compiler listings 

generated by a create file 
command F-65 
showing *NOLOC 4-90 
showing screen size location 4-94 
with description of parts F-65 
Debugging Template F-69 
definition H-4 
form 1-10 
Form Type (position 6) 

for communications files or BSC 
files 6-3 


data description specifications (DDS) (continued) 
Form Type (position 6) (continued) 
for display files 4-3 
for logical files 3-5 
for physical files 2-3 
for printer files 5-3 
keyword and value abbreviations G-1 
processor 1-15 
syntax 1-22 
syntax coding example 

for communications files or BSC 
files 1-21,6-11 
for display files 1-19, 4-34 
for logical files 1-18, 3-27 
for physical files 1-17, 2-12 
for printer files 1-20, 5-13 
data description, concept of 1-1 
data-entry keyboard 4-27 
data error 6-15 
data file utility (DFU) 
column headings 

for logical files 3-35 
for physical files 2-18 
entering data records to a physical 
file 1-9 

data file utility, definition of H-4 
data file, definition of H-4 
data link, definition of H-4 
data management 1-2 
data management feedback area 
contents contfolled by routing 
keywords 4-149 
updated after command key 
pressed 4-43, 4-47 
Data Management indicators (see option 
indicators; 

response indicators) 
data records 

effect of access path on 1-5 
entering In physical files 1-3, 1-9 
data stream, definition of H-4 
data transformation, definition of H-4 
Data Type (position 35) 

(see also Keyboard Shift (position 35)) 

A (character) 

for communications files or BSC 
files 6-10 
for display files 4-17 
for logical files 3-24 
for physical files 2-10 
for printer files 5-9 
B (binary) 

for communications files or BSC 
files 6-10 
for logical files 3-24 
for physical files 2-10 
definition H-4 
internal 4-17 
P (packed decimal) 
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Data Type (position 35) (continued) 

P (packed decimal) (continued) 
for communications files or BSC 
files 6-10 
for logical files 3-24 
for physical files 2-10 
positional entry 

for communications files or BSC 
files 6-10 
for display files 4-15 
for logical files 3-24 
for physical files 2-10 
for printer files 5-9 
S (zoned decimal) 

for communications files or BSC 
files 6-10 

for display files 4-17, 4-26 
for logical files 3-15, 3-24 
for physical files 2-10 
for printer files 5-9 
transformation of in concatenated 
fields 3-24 
valid entries 

for communications files or BSC 
fiJes 6-10 
for display files 4-17 
for logical files 3-24 
for physical files 2-10 
for printer files 5-9 
data validation (see validity checking) 
data, magnetic stripe 4-63 
DATE 

coding example 

for display files 4-74 
for printer files 5-15 
editing of date field 

for display files 4-74 
for printer files 5-19 
keyword description 

for display files 4-74 
for printer files 5-15 
DDS (see Data Description Specifications) 
Debugging Template F-69 
Decimal Positions (positions 36 through 37) 
for communications files or BSC 
files 6-11 

for display files 4-28 
for logical files 3-25 
for physical files 2-11 
for printer files 5-9 
decimals 

display length increased for 4-26 


in edit words 

for display files 

4-79 

for logical files 

3-43 

for physical files 

2-24 

for printer files 

5-23 

with QDECFMT 

for display files 

4-74 

for printer files 

5-19 


default value, definition of H-4 
defaults 

COLHDG for TEXT 2-18, 3-35 
for And/Or/Comment (position 7) 
in communications files or BSC 
files 6-4 
in display files 4-3 
in printer files 5-3 
for Data Type (position 35) 

in communications files or BSC 
files 6-10 

in display files 4-16, 4-19 
in physical files 2-10 
in printer files 5-9 
for Usage (position 38) 
in display files 4-26 
in printer files 5-9 
input-capable fields 
underlined 4-26, 4-55 
key field without SIGNED, ABSVAL, ZONE or 
DIGIT 3-39 

definition response, definition of H-4 
delay maintenance, definition of H-4 
delete, definition H-4 
DESCEND 

coding example 

for logical files 3-39 
for physical files 2-19 
keyword description 
for logical files 3-39 
for physical files 2-19 
with SIGNED 2-31 
descending key sequence, definition 
of H-4 

descending sequence, definition of H-4 
described data concept 1-1 
describing files level by level 1-16 
device class indicator (see RTGDEVCLS) 
device data management 1-2, 1-7 
device description, definition of H-4 
device files 

coding characteristics 1-9 
communications (see communications files; 
BSC files) 
definition H-4 
description 1-7 
display (see display files) 
printer (see printer files) 
work stations (see display files) 

DFT 

coding example 

for display files 4-75 
for printer files 5-16 
keyword description 
for display files 4-75 
for printer files 5-16 
DFU (data file utility) 
column headings 

for logical files 3-35 
for physical files 2-18 
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DFU (data file utility) (continued) 

DSPATR (continued) 

entering daa records to a physical 

(MDT) Set Modified Data Tag 4-83 

file 1-9 

with ERASEINP 4-108 

DIGIT 

with MDTOFF 4-124 

coding example 

(ND) Nondisplay 4-82 

for logical files 3-39 

(01D) Operator Identification 4-83 

for physical files 2-20 

(PC) Position Cursor 4-82 

keyword description 

(PR) Protect 4-84 

for logical files 3-39 

with ERASEINP 4-108 

for physical files 2-20 

with MDTOFF 4-124 

digit portion 2-33, 3-54 

(Rl) Reverse Image 4-82 

digit replace position 2-24 

(SP) Select by Light Pen 4-59, 4-8^ 

digit definition of H-4 

(UL) Underline 4-66, 4-83 

diskette drive, definition of H-4 

coding example 4-81 

diskette files 

keyword description 4-80 

DDS not valid for 1 -4, 1 -8 

valid parameter values 4-80 

definition H-4 

DSPSIZ 

diskette magazine drive, definition 

coding example 4-89 

of H-4 

for screen size conditions 4-5 

display attribute character (see attribute 

keyword description 4-87 

character) 

valid locations 4-31 

display attributes (see DSPATR) 

DTAMBRS parameter value (see CRTLF { 

display file 

Logical File) 

coding examples F-12, 4-2 

command; ADDLFM (Add Logical File 

definition H-5 

command) 

keyword entries 4-34 

DUP 

keyword summary C-1 

coding example 4-97 

positional entries 4-3 

keyword description 4-96 

valid keywords for 4-35 

Dup key 

display length of a field 4-15, 4-33 

with CHECK(RB) 4-61 

display screen, definition of H-5 

with DUP 4-96 

display size (see DSPSIZ) 

with PRINT 4-134 

display station, definition of H-5 

duplicate key values 

display, definition of H-5 

(see LIFO; UNIQUE) definition H-5 

DLTCHK 

duplicating function (see DUP) 

assumed when new field attribute 


specified 


for display files 4-13 


assumed when new field attribute 


for printer files 5-7 


coding example 4-78 


keyword description 4-78 

edit/check algorithm (see CHECK, as 

DLTEDT 

validity checking keyword) 

assumed when new field attribute 

edit code 

specified 

(see also EDTCDE) 

for display files 4-13 

definition H-5 

for printer files 5-7 

edit description, definition of H-5 

coding example 

edit functions (see EDTCDE; EDTWRD) 

for display files 4-79 

Edit Source (EDTSRC) command 1-12 

for printer files 5-17 

edit word 

keyword description 

(see also EDTWRD) 

for display files 4-79 

definition H-5 

for printer files 5-17 

edit, definition of H-5 

DN (AID byte) 4-151 

EDTCDE 

DSPATR 

(see also DLTEDT) 

(BL) Blink 4-82 

asterisk fill 

(CS) Column Separator 4-82 

for display files 4-98 

(HI) High Intensity 4-82 

for logical files 3-41 


for physical files 
for printer files 


2-22 

5-20 
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EDTCDE (continued) 
coding example 

for display files 4-102 
for logical files 3-40 
for physical files 2-22 
for printer files 5-21 
CPF edit codes 

for display files 4-98 
for logical files 3-41 
for physical files 2-21 
for printer files 5-18 
definition of edit code H-5 
edited output chart 

for display files 4-101 
for printer files 5-19 
floating currency symbol 
for display files 4-100 
for logical files 3-41 
for physical files 2-22 
for printer files 5-20 
keyword description 
for display files 4-98 
for logical files 3-40 
for physical files 2-21 
for printer files 5-18 
user-defined edit codes 
definition H-13 
for display files 4-100 
for logical files 3-41 
for physical files 2-21 
for printer files 5-20 
EDTSRC (Edit Source) command 1-12 
EDTWRD 

(see also DLTEDT) 
asterisk protection 

for display files 4-104 
for logical files 3-43 
for physical files 2-24 
for printer files 5-23 
coding example 

for display files 4-106 
for logical files 3-43 
for physical files 2-24 
for printer files 5-24 
definition of edit word H-5 
fixed currency symbol 
for display files 4-104 
for logical files 3-43 
for physical files 2-24 
for printer files 5-23 
floating currency symbol 
for display files 4-104 
for logical files 3-43 
for physical files 2-24 
for printer files 5-23 
keyword description 

for display files 4-103 
for logical files 3-42 
for physical files 2-23 
for printer files 5-22 


EDTWRD (continued) 
with DATE 

for display files 4-74 
for printer files 5-15 
with TIME 

for display files 4-103 
for printer files 5-38 
embedded blank 
definition H-5 
in DDS syntax 1-22 
end-of-text character, definition of H-5 
end-of-transmission-block character, 
definition of H-5 

end-of-transmisslon character, definition 
of H-5 
ENDGRP 

(see also RCVENDGRP) 
coding example 6-14 
description 6-14 
ending attribute character 
definition H-5 
description 4-15, 4-16, 4-32 
enquiry character, definition of H-5 
Enter/Rec Adv key, as ROLLUP 4-171 
enter, definition of H-5 
ER (end of record) 4-59 
ERASE 

(see also OVERLAY) 
coding example 4-107 
keyword description 4-107 
Erase Input key 4-37 
ERASEINP 

coding example 4-108 
keyword description 4-108 
erasing 
fields 

with ERASEINP 4-108 
with UNLOCK 4-204 
record formats 

with ERASE 4-107 
ERRMSG 

(see also ERRMSGID; MSGLOC) 
coding example 4-110 
ignored when INZRCD processed 4-119 
keyword description 4-110 
OVERLAY assumed for 4-129 
processing order 4-113 
with CAnn 4-45 
with CFnn 4-48 
ERRMSGID 

(see also ERRMSG; MSGLOC) 
coding example 4-110 
ignored when INZRCD processed 4-119 
keyword description 4-110 
OVERLAY assumed for 4-113 
processing order 4-113 
with CAnn 4-45 
with CFnn 4-48 
error message location 4-126 
examples, coding (see coding examples) 



exception response, definition of H-5 
execution time H-5 
definition H-5 
usage 1-2 

external message queue, definition of H-5 
externally described data 
definition H-5 
description 1-1 

externally described file, definition 
of H-6 


FAIL 

coding example 6-15 
keyword description 6-15 
FE (field exit check) 4-59 
field 

conditioning of 
definition H-6 
for display files 4-3 
for printer files 5-3 
definition H-6 
display length 4-15 
length 

for communications files or BSC 
files 6-8 

for display files 4-15 
for logical files 3-22 
for physical file. 2-9 
for printer files 5-8 
location 

for communications files or BSC 
files 6-11 

for display files 4-31 
for logical files 3-26 
for physical files 2-11 
for printer files 5-10 
program length 4-15 
type (see Data Type (position 35)) 
usage (see Usage (position 38)) 4-28 
field exit keys 4-21, 4-61 
field level 
description 

for communications files or BSC 
files 1-21 

for display files 1-19 
for logical files 1-18 
for physical files 1-17 
for printer files 1 -20 
keyword summary 

for communications files or BSC 
files E-4 

for display files C-15 

for physical and logical files B-6 

for printer files D-4 


field name 

as column heading 2-16 
at the select/omit level 3-20 
specification of 

for communications files or BSC 
files 6-6 

for display files 4-11 
for logical files 3-8 
for physical files 2-3 
for printer files 5-5 
with CONCAT 3-8 
with REFFLD 

for display files 4-146 
for physical files 2-30 
for printer files 5-31 
with RENAME 3-8, 3-49 
field reference file 

coding example F-6 
definition H-6 
description 1-5 
field selection 
definition H-6 
in subfiles 

description 4-185, 4-197 
example F-37 

through conditioning (see Conditioning, 
(positions 7 through 16)) 
through select/omit specifications 
with ALL 3-32 
with COMP or CMP 3-36 
with RANGE 3-48 
with VALUES 3-53 
field, both 4-28 

field, functions (see functions (positions 
45-80)) 
field, hidden 

description 4-29, 4-95 
with CSRLOC 4-72 
field, input-capable 

(see also field, input-only; field, 
output/input) 
definition H-6 
description 4-28 
field, input-only 4-28 
field, message 
definition H-8 
description 4-28 
with DSPSIZ 4-95 
field, output-capable (see field, 
output-only; field, 
output/input) 
field, output/input 4-28 
field, output-only 4-28 
field, output, definition of H-9 
fields 

concatenation of 3-37 
overlapping 4-95 
FIFO (first-in-first-out) 

as default for LIFO 2-26 
example 2-6 
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creating 1-15 

defining a file through DDS 

communications or BSC files 6-1 
display files 4-1 
logical files 3-2, 3-3 
physical files 2-1 
printer files 5-1 
definition H-6 
name 1-15 
types of 1 -3 
file creation time 1-2 
file description, definition of H-6 
file level 
description 

for communications files or BSC 
files 1 -21 

for display files 1-19 
for logical files 1-18 
for physical files 1-17 
for printer files 1-20 
keyword summary 

for communications files or BSC 
files E-4 

for display files C-15 
for logical files B-6 
for physical files B-6 
for printer files D-4 
FILETYPE{*SRC) 
with ALTSEQ 

for logical files 3-33 
for physical files 2-16 
with LIFO 

for logical files 3-45 
for physical files 2-26 
first-ln-first-out (see FIFO) 
first-level message, definition H-6 
fixed currency symbol 
definition H-6 
in edit words 

for display files 4-104 
for logical files 3-43 
for physical files 2-24 
for printer files 5-23 
floating currency symbol 
definition H-6 
in edit codes 

for display files 4-100 
for logical files 3-42 
for physical files 2-22 
for printer files 5-20 
In edit words 

for display files 4-104 
for logical files 3-43 
for physical files 2-24 
for printer files 5-23 
FOLD(*YES) parameter value 5-12 
fold, definition of H-6 
folding (see BLKFOLD) 


Form Type (position 6) 

for communications files or BSC 
files 6-3 

for display files 4-3 
for logical files 3-5 
for physical files 2-3 
for printer files 5-3 
form. Data Description 
Specifications 1-10 
FORMAT 

(see also record format name) 
coding example 

logical files 3-44 
physical files 2-24 
keyword description 
logical files 3-44 
physical files 2-24 
format name (see record format name) 
FORMSIZE parameter 5-10 
Function (CF) key (see CFnn) 
function key 

(see also command function key) 
definition H-6 
Functions (positions 45-80) 

(see also individual keywords) 
syntax 1-22 


get-next-changed (see SFLNXTCHG) 
get operation, definition of H-6 
GETRETAIN 

(see also UNLOCK) 
coding example 4-114 
keyword description 4-114 


H (in position 38) 

(see Usage (position 38)) 

HELP 

(see also VLDCMDKEY) 
coding example 4-115 
keyword description 4-115 
Help key 

with ERRMSG 4-110 
with HELP 4-115 
with message (M) field 4-30 
with SFLMSGID 4-176 
help text, definition of H-6 
hex (see hexadecimal) 
hexadecimal, definition of H-6 
HI (High Intensity) 4-82 
hidden fields 

definition H-6 
description 4-28, 4-95 



hidden fields (continued) 

locations not valid for 4-31 
high intensity 4-82 
high-level languages 

COBOL Data Division F-64 
definition H-6 
RPG III 

file specifications F-62 

restrictions on duplicate names 3-49 

restrictions on lengths of names 3-6, 4-11 

HOME 

(see also VLDCMDKEY) 
coding example 4-116 
keyword description 4-116 
Home key 4-116 
Home position 4-116 
HP (AID byte) 4-151 


I 

in position 35 (see Keyboard Shift 
(position 35)) 

in position 38 (see Usage (position 39)) 
I/O feedback area (see data management 
feedback area) 

I/O operation 1-2 

immediate maintenance, definition of H-6 
inactive record, definition of H-6 
Indicator (positions 9-10, 12-13, 15-16) 
(see Conditioning (positions 7 through 
16)) 

definition H-6 
indicator- usage-text 

for communications files or BSC 
files 6-16 

for display files 4-116 
for printer files 5-26 
indicators 

definition H-6 

for input (see response indicators) 
for output (see option indicators) 
INDTXT 

coding example 

for communications files or BSC 
files 6-16 

for display files 4-116 
for printer files 5-26 
keyword description 

for communications files or BSC 
files 6-16 

for display files 4-116 
for printer files 5-26 
Inhibit Keyboard Entry 4-21 
initialize, definition of H-6 


initialized fields 
with DFT 

for display files 4-75 
for printer files 5-16 
initialized screen 4-37 
initialized subfile 4-172, 4-191 
inline data file, definition of H-6 
input-capable field, definition of H-6 
input file, definition of H-7 
input operation 1 -2 
input stream, definition of H-7 
input, definition of H-6 
inquiry, definition of H-7 
integer, definition of H-7 
Interactive Data Base Utilities, definition 
of H-7 

interactive entry of DDS 1-12 
interactive job, definition of H-7 
interactive processing, definition of H-7 
interactive, definition of H-7 
internal storage, definition of H-7 
INZRCD 

coding example 4-118 
keyword description 4-118 


Job date 

(see also DATE) 
definition H-7 

job description, definition of H-7 
job log 

definition H-7 
with LOGINP 4-122 
with LOGOUT 4-123 
job message queue, definition of H-7 
job name, definition of H-7 
job, definition of H-7 
Julian date (JUL) 
definition H-7 
with EDTCDE(Y) 

for display files 4-99, 4-1(X) 
for printer files 5-15, 5-19 


K in position 17 (key field level) 
(see also access path, UNIQUE) 
specification of 

for logical files 3-9 
for physical files 2-3 
Katakana 4-21 
KEEP 

coding example 4-120 
keyword description 4-120 
key definition 
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key field level 

(see also key field name) 
description 

for logical files 1*18 
for physical files 1-17 
keyword summary 

for logical files B-6 
for physical files B-6 
key field name 

(see also access path; UNIQUE) 
for logical files 3-9 
for physical files 2-6 
key field, definition of H-7 
key in, definition of H-7 
key position 3-11 
key position attribute checking 3-11 
keyboard control 4-59 
keyboard lock 4-121 
Keyboard Shift (position 35) 

(see also LC) 
attributes 

A (Alphameric Shift) 4-18 
I (Inhibit Keyboard Entry) 4-21 
N (Numeric Shift) 4-18 
S (Signed Numeric) 4-18 
W (Katakana) 4-21 
X (Alphabetic Only) 4-18 
Y (Numeric Only) 4-20 
automatic shifting 4-17, 4-27 
examples 4-22 
lower 4-26 
upper 4-27 
valid entries for 4-17 
keyboard type 

data-entry 4-27 
typewriter-1 ike 4-26 
keyed sequence access path 
(see also access path) 
definition H-7 
description 1-5 
with ACCPTH 3-30 
with key field name 
for logical files 3-9 
for physical files 2-6 
keyed sequence, definition of H-7 
keyword and value abbreviations G-1 
keyword entries 

for communications files 6-12 
for display files 4-34 
for logical files 3-27 
for physical files 2-12 
for printer files 5-13 
keyword summary 

communications file or BSC file E-1 
display file C-1 
logical and physical file B-1 
printer file D-1 
keyword, definition of H-7 


keywords listed by groups 

for communications files B-3 
for display files C -12 
for logical files B-5 
for physical files B-5 
for printer files D-3 
keywords listed by level 

for communications files or BSC 
files E-4 

for display files C-15 
for logical files B-6 
for physical files B-6 
for printer files D-4 
keywords, parameter values for 1-22 


last-in-first-out (see LIFO) 

LC (lowercase) 4-59 
leading zero suppression 
for display files 4-73 
for logical files 3-40 
for physical files 2-21 
for printer files 5-18 
left-adjust, definition of H-7 
Length (positions 30-34) 
specification of 

for communications files or BSC 
files 6-8 

for display files 4-14 
for logical files 3-22 
for physical files 2-9 
for printer files 5-8 
level checking, definition of H-8 
library list (*LIBL), definition of H-8 
library, definition of H-8 
LIFO (last-in-first-out) 

(see also UNIQUE) 
coding example 

for logical files 3-45 
for physical files 2-26 
keyword description 
for logical files 3-45 
for physical files 2-26 
light pen 4-63, 4-64 
Line (positions 39-41) 

for communications files or BSC 
files 6-11 

for display files 4-28 
for logical files 3-18 
for physical files 2-11 
for printer files 5-11 
line traffic, definition of H-8 
listing, definition of H-8 
literal 

definition H-8 
general syntax rules for 1 -22 
local work station, definition of H-8 



Location (positions 39-44) 

for communications files 6-11 
for display files 4-28 
for tbgical files 3-26 
for physical files 2-11 
for printer files 5-10 
LOCK 

coding example 4-121 
keyword description 4-121 
logical and physical file keyword 
summary B-1 
logical file member 
definition H-8 
description 3-9 
logical files 

coding examples F-4, 3-4 
definition H-8 
description 1 -3 
keyword entries 3-27 
keyword summary B-1 
more than one record format 3-3, 3-11 
positional entries 3-5 
valid keywords for 3-28 
LOGINP 

coding example 4-122 
keyword description 4-122 
LOGOUT 

coding example 4-123 
ignored With INZRCD 4-119 
keyword description 4-123 
LOWER 

keyword description 4-123 
with keyboard shift attribute 4-26, 4-27 
lowercase (see LOWER) 

LP (AID byte) 4-151 


M in position 38 (see message field (M in 
position 38)) 

magazine, definition of H-8 
magnetic card reader 4-83 
magnetic stripe data 4-84 
MAINT(*IMMED) 
with UNIQUE 

for logical files 3-52 
for physical files 2-34 
maximum (see restrictions) 

MBR(*NONE) 1-5 

MDT (Modified Data Tag) (see Modified Data 
Tag) 

MDTOFF 

coding example 4-125 
keyword description 4-124 
ME (mandatory enter) 4-55 
member, definition of H-8 


menu 

definition H-8 
example F-12 
merging records 3-11 
message field (M in position 38) 
definition H-8 
description 4-30 
with DSPSIZ 4-95 
message file, definition of H-8 
message identifier, definition of H-8 
message reference key 
definition H-8 
with SFLMSGKEY 4-179 
message subfile 

(see also SFLMSGRCD; SLFMSG; SFLMSGID; 
SFLMSGKEY; 

SFLPGMQ) 
building 4-187 
display example F-46 
predefined fields 4-179, 4-188 
messages 

definition H-8 
in compiler listings F-67 
in display files 

location on display (see MSG LOG) 
message field (see message field (M in 
position 38)) 

message identifier in DDS (see 
ERRMSGID; SFLMSGID) 
message subfile (see message subfile) 
text in DDS (see ERRMSG; SFLMSG) 

MF (mandatory fill) 4-58 
minus sign 
in edit word 

for display files 4-101, 4-104 
for logical files 3-43 
for physical files 2-24 
for printer files 5-19, 5-24 
to increase length of a field 

in communications files or BSC 
files 6-10 
in display files 4-16 
in logical files 3-23 
in physical files 2-9 
In printer files 5-8 

to increase number of decimal positions 
in a field 

in communications files or BSC 
files 6-10 
in display files 4-28 
in logical files 3-25 
in physical files 2-11 
in printer files 5-9 
to indicate continuation 1 -23 
Modified Data Tag (MDT) 
definition H-8 
with CHANGE 4-50 
with DSPATR 4-83, 4-86 
with ERASEINP 4-108 
with MDTOFF 4-124 
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Modified Data Tag (MDT) (continued) 
with SFLNXTCHG 4-182 
with UNLOCK 4-204 
modulus 10 checking/modulus 11 checking 
definition H-8 
description 4-55 
MSGLOC 

(see also ERRMSG; ERRMSGID; SFLMSG; 
SFLMSGID) 

coding example 4-127 
keyword description 4-126 
multiple output operation to a message 
subfile 4-178 

M10 (Modulus 10) H-8, 4-55 

Mil (Modulus 11) H-8, 4-55 


N 

in position 35 (see Keyboard Shift 
(position 35)) 

in positions 8, 11, 14 (See Conditioning 
(positions 7 
through 16) 

N*DS1, N*DS2, or N*DS3 4-3 
Name (positions 19-28) 
description 1-10 
for communications files or BSC 
files 6-6 

for display files 4-11 
for logical files 3-6 
for physical files 2-4 
for printer files 5-5 
Name Type (position 17) 
description 1-10 
for communications files or BSC 
files 6-5 

for display files 4-10 
for logical files 3-5 
for physical files 2-3 
for printer files 5-5 
ND (Nondisplay) 4-82, 4-83 
negative response, definition of H-8 
NOALTSEQ 

(see also ALTSEQ) 
coding example 

for logical files 3-45 
for physical files 2-27 
keyword description 
for logical files 3-45 
for physical files 2-27 
NOLOC 4-90 
nondisplay fields 

*NOLOC on source listing 4-90 
with DSPATR(ND) 4-82 
NONE 3-8 

Not (positions 1, 11, 14) (see Conditioning 


Not (positions 1, 11, 14) (see Conditioning (continued) 
(position7 through 16)) 

NOWAIT 4-86 

numeric character, definition H-8 
number restrictions 

of bytes per record in a communications 
file or BSC file 6-1 
of bytes per record in a display 
file 4-1 

of bytes per record in a logical 
file 3-22 

of bytes per record in a physical 
file 2-9 

of bytes per record in a printer 
file 5-1 

of column headings 2-18, 3-35 
of concatenated fields 3-37 
of decimal positions 2-11, 3-25 
of fields per record format in 
a physical file 2-2 
of fields per record format In 
a logical file 3-2 
of fields per record format in 
in a display file 4-1 
of fields per record format In 
a printer file 5-1 
of fields per record format in 
a communications file or BSC file 6-1 
of lines skipped in printing 5-33, 5-34 
of lines spaced in printing 5-35, 5-36 
of lines used for printing 5-10 
of pages numbered before reset 5-27 
of physical file names with PFILE 3-46 
of positions used for printing 5-10 
of record formats In a communications 
file or BSC file 6-1 
of record formats in a display file 4-1 
of record formats in a logical file 3-2 
of record formats in a physical 
file 2-2 

of record formats In a printer file 5-1 
of subfile records 4-197 
of subfiles active in one display 
file 4-164 

of values with VALUES 3-53, 4-207 
numeric character, definition H-8 
numeric data type 

(see Data Type (position 35), B (binary) 

(see Data Type (position 35), P (packed 
decimal)) 

(see Data Type (position 35), S (zoned 
decimal)) 

numeric field, definition of H-8 
numeric literal 

definition of H-8 
syntax rules for 1-22 
Numeric Only 4-17, 4-27 
Numeric Shift 4-18 
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O in position 17 (see seiect/omit 
specifications) 

object name, definition of H-9 
object definition of H-9 
OiD (Operator Identification) 4-83 
omit function, definition of H-9 
open data path, definition of H-9 
open, definition of H-9 
OPENPRT (see also PRINT) 
coding example 4-128 
keyword description 4-128 
operational rights 
definition H-9 
to alternate collating 
sequences 2-16, 3-32 
to message files 4-113, 4-118 
operator 

system operator H-13 
work station user, definition H-13 
operator identification 4-83 
option indicators 

(see also Conditioning (positions 7 
through 16)) 
definition H-9 

for communications files or BSC 
files 6-4 

for display files 4-4 
for printer files 5-4 
OR, logical (O in position 7) 

(see also Conditioning (positions 7 
through 16)) 

for communications files 6-5 
for display files 4-4 
for printer files 5-4 
Order Department Clerk Menu F-12 
output field, definition of H-9 
output file, definition of H-9 
output/input field 
definition H-9 
description 4-30 
output operation 1 -2 
output, definition of H-9 
overflow condition, definition of H-9 
overflow handling, definition of H-9 
overflow indicator, definition of H-9 
overflow line 

definition H-9 
description 5-10 
overflow page, definition of H-9 
overflow, definition of H-9 
overlapping fields 
definition H-9 
description 

in display files 4-32, 4-95 
in printer files 5-10 
OVERLAY 

coding example 4-130 
keyword description 4-129 


override 

of data type 3-24 
of decimal positions for binary 
fields 3-26 

of referenced field attributes 
for display files 4-13 
for logical files 3-25 
for physical files 2-7 
Override with Printer File (OVRPRTF) 
Command 5-12 
OVRATR 

coding example 4-140 
keyword description 4-138 
OVRDTA 

coding example 4-140 
keyword description 4-131 
OVRFLW parameters 5-10 
OVRPRTF (Override with Printer File 
Command) command 5-12 


P (in position 35) (see Data Type, P 
(packed decimal)) 

packed decimal data (see Data Type, P 
(packed decimal)) 

packed decimal format, definition of H-9 

packed field, definition of H-9 

packed key, definition of H-9 

page number (see PAGNBR) 

page overflow 5-10 

page, definition of H-9 

PAGNBR 

coding example 5-27 
keyword description 5-27 
parameter values 1-22 
parameter, definition of H-9 
parentheses, parameter values in 1-22 
PASSRCD 

coding example 4-132 
keyword description 4-132 
PC (Position Cursor) 4-82 
performance considerations 
arithmetic operations 2-9 
reduced line traffic 4-138 
PFILE (for logical files only) 
coding example 3-46 
keyword description 3-46 
with record format name 3-7 
physical file 

coding examples F-3, 2-2 
definition H-9 
description 1-3 
keyword entries 2-11 
keyword summary B-1 
order of entries 2-2 
positional entries 2-2 
valid keywords for 2-13 
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physical file member 
definition H-9 

none in field reference file 1 -5 
plus sign 

to increase length of a referenced field 
in communications files or BSC 
files 6-9 

in display files 4-16 
in logical files 3-23 
in physical files 2-9 
in printer files 5-8 
to indicate continuation 1 -23 
to indicate end of page 4-160 
Pos (positions 42-44) 

for communications files or BSC 
files 6-11 

for display files 4-31 
for logical files 3-26 
for physical files 2-11 
for printer files 5-11 
position cursor (DSPATR (PC)) 4-82 

positional entries 

for communications files or BSC 
files 6-3 

for display files 4-3 
for logical files 3-5 
for physical files 2-3 
for printer files 5-3 
positive response, definition of H-7 
PR (Protect) 4-84, 4-108 
primary screen size 4-5 
PRINT 

(see also OPENPRT; VLDCMDKEY) 
coding examples 4-134, 4-135, 4-136 
keyword description 4-133 
with nondisplay fields 4-82 
Print key 4-133 

printed length of a field 5-8, 5-22 
printer device 1-8 
printer/display layout, definition 
of H-10 
printer files 

coding examples F-57, 5-2 
definition H-10 
keyword entries 5-13 
keyword summary D-1 
positional entries 5-2 
valid keywords for 5-14 
program compilation time 1 -2 
program-described data 
definition H-10 
description 1-8 
program-described file, definition 
of H-10 

program length of a field 4-15, 5-8 
program message queue 
definition H-10 
with SFLPGMQ 4-187 
program, definition of H-10 


prompt 

definition H-10 
example F-14, F-17 
PROTECT 

coding example 4-137 
keyword description 4-137 
protect function 

all input-capable fields 4-137 
individual input-capable fields 4-84 
protected field, definition of H-10 
PRTFILE parameter value 4-134 
PT (AID byte) 4-151 
put-get operation, definition of H-10 
put operation, definition of H-10 
PUTOVR 

coding example 4-140 
keyword description 4-138 
PUTRETAIN 

coding example 4-142 
keyword description 4-141 


QCURSYM 
with EDTCDE 

for display files 4-100 
for logical files 3-41 
for physical files 2-22 
for printer files 5-18 
with EDTWRD 


for display files 4-104 
for logical files 3-43 
for physical files 2-24 
for printer files 5-23 
QDATFMT 

with EDTCDE(Y) 

for display files 4-74, 4-99 
for printer files 5-15, 5-19 
QDATSEP 


in sample output 

for display files 4-101 
for printer files 5-20 
with DATE and EDTCDE(Y) 
for display files 4-74, 4-99 
for printer files 5-19 
QDDSSRC 1-9 
QDECFMT 


Input data processing 4-10 
output data processing 
for display files 4-99 
for printer files 5-19 
QSYSPRT 4-134 


qualified object name 
definition H-10 
in DDS syntax 1 -22 
query utility column headings 
for logical files 3-35 
for physical files 2-18 



query, definition of H-10 
queue, definition of H-tO 


R 

in position 17 (see Name Type (position 
17)) 

in position 29 (see Reference (position 
29)) 

RA (Record Advance) 

AID byte 4-109 
keyboard control code 4-61 
RAB (Right Adjust with Blank Fill) 4-61 
RANGE 

as select/omit level keyword 
for logical files 3-48 
as validity checking keyword 
for display files 4-145 
for logical files 3-48 
for physical files 2-27 
coding example 

for display files 4-143 
for logical files 3-48 
keyword description 

for display files 4-143 
for logical files 3-48 
for physical files 2-27 
RAZ (Right Adjust with Zero Fill) 4-61 
RB (ight adjust with blank fill) 4-61 
RCVENDGRP 

coding example 6-17 
keyword description 6-17 
read operation 1 -2 
reader, definition of H-10 
rebuild maintenance, definition of H-10 
Record Advance (AID byte) 4-151 
Record Backspace (AID byte) 4-151 
record format 

definition H-10 
in logical files 3-3 
in physical files 2-1 
record format level identifier, definition 
of H-10 

record format name 

(see also Name Type (position 17)) 
specification of 

for communications files or BSC 
files 6-6 

for display files 4-10 
for logical files 3-7 
for physical files 2-4 
for printer files 5-5 
record level 
description 

for communications files or BSC 
files 1-21 


record level (continued) 
description (continued) 
for display files 1-19 
for logical files 1-18 
for physical files 1-17 
for printer files 1-20 
keyword summary 

for communications files or BSC 
files E-4 

for display files C-15 
for logical files B-6 
for physical files B-6 
for printer files D-4 
record, definition of H-10 
records 

entering into a physical file 1 -9 
retrieving (see access path) 
sequencing (see also access path) 1 -9 
REF 

coding example 

for communications files or BSC 
files 6-19 

for display files 4-145 
for physical files 2-28 
for printer files 5-30 
how to specify with REFFLD A-1 
keyword description 

for communications files or BSC 
files 6-18 

for display files 4-144 
for physical files 2-29 
for printer files 5-29 
Reference (R in position 29) or BSC files 
for communications files 6-7 
for display files 4-13 
for logical files 3-22 
for physical files 2-8 
for printer files 5-7 
referenced field 

(see also Reference (R in position 29); 
REF; REFFLD) 

with decimal positions changed 2-11 
with field length changed 2-9 
referenced field name (see REFFLD) 
referenced file (see REF) 

REFFLD 

*SRC parameter value 

for communications files or BSC 
files 6-20 

for display files 4-146 
for physical files 2-28 
for printer files 5-31 
coding example 

for communications files or BSC 
files 6-20 

for display files 4-147 
for physical files 2-29 
for printer files 5-32 
how to specify with REF A-1 
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REFFLD (continued) 
keyword description 

for communications files or BSC 
files 6-20 

for display files 4-146 
for physical files 2-28 
for printer files 5-31 
relational operator 
definition H-10 
with CMP or COMP 4-70 
remote work station, definition of H-10 
remote 5250 work station 4-134 
RENAME 

coding example 3-49 
keyword description 3-49 
request definition of H-11 
Reserved (position 19) 

for communications files 6-5 
for display files 4-10 
for logical files 3-6 
for physical files 2-4 
for printer files 5-5 
Reset key 

with ERRMSG/ERRMSGID 4-110 
with MSGLOC 4-126 
with SFLMSG/SFLMSGID 4-176 
response indicator 
definition H-1l 
with BLANKS 4-39 
with CAnn 4-43 
with CFnn 4-46 
with CHANGE 4-50 
with CLEAR 4-67 
with DUP 4-96 
with ERRMSG 4-110 
with HELP 4-115 
with HOME 4-116 
with INDTXT 4-116, 6-16 
with RCVENDGRP 6-17 
with ROLLUP or ROLLDOWN 4-148 
with SETOFFor SETOF 4-157 
with SFLMSG 4-176 
with TRNRND 6-26 
with VLDCMDKEY 4-208 
response time 4-21 
response, definition of H-11 
restrictions 

attribute characters on displays 4-31 
length 

imposed by high-level languages 2-9 
imposed by RPG III 3-6 
of a single specification 1 -23 
of all fields and indicators in a 
display file 4-1 

of column headings 2-18, 3-35 
of composite key 2-6 
of numeric fields 4-15 
of records in a physical file 2-9 
of zoned decimal field 5-8 


restrictions (continued) 
limitations of validity 
alternate collating 
sequences 2-16, 3-33 
input operation to a subfile 4-168 
screen sizes vs location 4-8 
number (see number restrictions) 
reverse image 4-83 
reverse-Interrupt character, definition 
of H-11 

reversed image field, restoration of 
04-030, 4-113 

Rl (Reverse Image) 4-83 
right-adjust, definition of H-11 
RL (right to left) 4-63 
RLTB (right to left, top to bottom) 4-63 
Roll Down key 4-148 
roll function (see SFLROLVAL) 

Roll Up key 4-148 

Enter/Rec Adv key as 4-171 
with SFLEND 4-169 
ROLLDOWN 

(see also VLDCMDKEY) 
coding example 4-148 
keyword description 4-148 
purpose 4-138 
ROLLUP 

(see also VLDCMDKEY) 
coding example (see ROLLDOWN, coding 
example) 

keyword description 4-148 
routing data, definition of H-11 
routing entry, definition of H-11 
routing field 

description 4-151 
location 4-150 

routing identification (RTG) field 4-150 
routing keywords 
coding example 

communications files or BSC 
files 6-23 
display files 4-150 
keyword description 4-150 

for communications or BSC files 6-20 
for display files 4-150 
routing step, definition of H-11 
RPG III 

blank input fields 4-39 

page overflow 5-10 

restrictions on duplicate names 3-7, 

3- 49 

restrictions on length of names 3-6, 

4- 11 

sample file specifications F-62 
RQSWRT 

coding example 6-21 
keyword description 6-21 
RTG AID 4-151 
RTGCON 4-151 
RTGDEV 4-152, 6-24 



RTGDEVCLS 4-152, 6-24 
RTGFIRST 4-152 
RTGFLD 4-153 
RTGFMT 4-153, 6-24 
RTGPOS 

coding example 4-154, 6-23 
keyword description 4-154, 6-24 
RTNDTA 

coding example 4-156 
keyword description 4-155 
rules, syntax . 1-22 
RZ (Right Adjust with Zero Fill) 4-61 


S 

in position 17 (see select/omit field 
name) 

in position 35 (see Data Type; Keyboard 
Shift) 

screen attribute character (see attribute 
character) 

Screen Design Aid (SDA) 
column headings 

in logical files 3-35 
in physical files 2-18 
creating and testing display fileswith 
SDA 1-9 
definition H-11 

screen location (see location (positions 
39-44); 

DSPSIZ; screen size condition names) 
screen size condition names 
display example F-43 
specifying 4-^5 
with DSPSIZ 4-87 
with field location 4-6 
with MSGLOC 4-126 
with SFLLIN 4-174 
with SFLMSGRCD 4-180 
with SFLPAG 4-184 
with SFLSIZ 4-197 
SDA (Screen Design Aid) 
column headings 

in logical files 3-35 
in physical files 2-18 
creating and testing display files 1 -9 
SDLC (see communications files) 
second-level message display, definition 
of H-11 

second-level message, definition of H-11 
secondary screen size 4-5 
security, definition of H-11 
select by light pen 4-83, 4-85 
select function, definition of H-11 
select/omit field name 
coding example 3-21 
description 3-20 


select/omit field, definition of H-11 
select/omit level 

(see also select/omit field name) 
description 1-18 
keyword summary B-6 
seif check algorithm 
Modulus 10 4-55 
Modulus 11 4-55 

self-check digit, definition of H-11 
self-check field, definition of H-11 
Sequence Number (positions 1-5) 
definition H-11 
for communications files or BSC 
files 6-3 

for display files 4-3 
for logical files 3-5 
for physical files 2-3 
for printer files 5-3 
sequential file, definition of H-11 
SETOF 

coding example 4-158 
keyword description 4-157 
SETOFF (see SETOF) 

SEU (see Source Entry Utility) 
severity code, definition of H-11 
SFL 

coding example 4-160 
keyword description 4-157 
required keywords (see SFLCTL; SFLDSP; 
SFLPAG; SFLSIZ) 

SFLCLR 

(see also SFLDLT; SFLINZ) 
coding example 4-161 
keyword description 4-161 
SFLCTL 

coding example 4-162 
keyword description 4-162 
required keyword (see SFLDSP; SFL; 
SFLPAG; SFLSIZ) 

SFLDLT 

(see also SFLCLR; SFLINZ) 
coding example 4-164 
keyword description 4-164 
SFLDROP 

coding example 4-165 
display example F-35 
keyword description 4-165 
SFLDSP 

coding example 4-167 
keyword description 4-167 
SFLDSPCTL 

coding example 4-168 
keyword description 4-168 
SFLEND 

coding example 4-170 
keyword description 4-169 
with ROLLUP 4-144 
SFLENTER 

coding example 4-171 
keyword description 4-171 
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SFLINZ 

coding example 4-173 
display example F-32 
keyword description 4-172 
with SFLRNA 4-191 
SFLLIN 

coding example 4-175 
keyword description 4-174 
with SFLDROP 4-165 
SFLMSG 

coding example 4-177 
ignored with INZRCD 4-118 
keyword description 4-176 
required keyword (see SFLDSP) 
SFLMSGID 

coding example 4-177 
ignored with INZRCD 4-118 
keyword description 4-176 
required keyword (see SFLDSP) 
SFLMSGKEY 

coding example 4-179 
keyword description 4-179 
SFLMSGRCD 

coding example 4-180 
keyword description 4-180 
SFLNXTCHG 

coding example 4-183 
keyword description 4-182 
with SFLRNA 4-191 
SFLPAG 

(see also SFLSIZ; SFLLIN) 
coding example 4-186 
keyword description 4-184 
SFLPGMQ 

coding example 4-188 
keyword description 4-187 
multiple output operation 4-187 
single output operation 4-187 
special value 4-188 
SFLRCDNBR 

(see also SFLROLVAL) 
coding example 4-190 
keyword description 4-189 
with CHECK(AB) 4-53 
SFLRNA 

coding example 4-192 
display example F-32 
keyword description 4-191 
SFLROLVAL 

(see also Roll key; SFLRCDNBR) 
coding example 4-194 
keyword description 4-193 
with CHECK(AB) 4-53 
SFLSIZ 

coding example 4-198 
keyword description 4-197 
shared access path 
(see also ACCPTH) 
definition H-11 
shared file, definition of H-12 


shared record format 
(see also FORMAT) 
definition H-12 

shared work station read (see RTNDTA) 
sign, including or omitting from output 
numbers 

with EDTCDE 

for display files 4-101 
for printer files 5-19 
with EDTWRD 

for display files 4-104 
for printer files 5-25 
SIGNAL, definition of H-12 
SIGNED 

(see also ABSVAL; DIGIT; ZONE) 
coding example 

for logical files 3-50 
for physical files 2-32 
keyword description 
for logical files 3-50 
for physical files 2-30 
signed numeric 4-18 
single output operation to a message 
subfile 4-187 
skip, definition of H-12 
SKIPA 

coding example 5-33 
keyword description 5-33 
SKIPB 

coding example 5-34 
keyword description 5-34 
SLNO 

coding example 4-201 
ERRMSG and ERRMSGID ignored 4 
keyword description 4-200 
sorting records (see access path) 
source entry utility (SEU) 1 -9 

browsing a compiler listing F-70 
creating source files 1-8 
definition H-12 
sample SEU display 1-13 
source file 

data descriptions in 1-12 
definition H-12 
IBM supplied 1-9 
source listing 

(see also compiler listing) 
definition H-12 

source member, definition of H-12 
source statement, definition of H-12 
SP (Select by Light Pen) 4-83, 4-84 
space, definition of H-12 
SPACEA 

coding example 5-35 
keyword description 5-35 
SPACES 

coding example 5-35 
keyword description 5-35 
special character, definition of H-12 
split-edit display (SEU) F-70 


-113 
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spooled file, definition of H>12 
spooled input file, definition of H-12 
spooled output file, definition of H-12 
SRC (see *SRC, as parameter value for 
REFFLD) 

start-of-text character, definition 
of H-12 

steps to creating a file 1 -9 
stop-zero-suppression character 2-^23 
subfile 

becomes active 4-164 
coding examples F-17 
definition H-12 

keywords not valid for subfile record 
format 4-159 

keywords valid for subfile control record 
format 4-162 

keywords valid for subfile record 
format 4-159 

message (see message subfile; SFLMSG; 
SFLMSGID) 

subfile control record format 
definition H-12 
description 4-162 
subfile record format 
definition H-12 
description 4-159 

Synchronous Data Link Control, definition 
of H-12 
syntax 

coding examples 

for communications files or BSC 
files 1-21 

for display files 1-19 
for logical files 1-18 
for physical files 1-17 
for printer files 1-20 
rules 1-22 

syntax checking, definition of H-12 
system console 

command functions 
Clear 4-67 
Help 4-115 

Print (CF24) 4-45, 4-48, 4-133 
cursor control 

right to left movement 4-63 
top to bottom movement 4-63 
definition H-12 
device class 4-152 
display attributes 

blinking cursor 4-38 
blinking field 4-82 
column separator 4-82 
high intensity 4-82 
operator identification 4-83 
position cursor 4-82 
reverse image 4-83 
select by light pen 4-84 
display size 4-5, 4-87 
Dup key 4-96 


system console (continued) 
keyboard lock 4t121 
messages 

location 4-126 
second-level text 4-115 
uppercase/lowercase 4-59 
validity checking 

field exit check 4-55 
mandatory enter 4-55 
mandatory fill 4-55 
system date 

DATE keyword 

in display files 4-74 
in printer files 5-15 
definition H-12 

system operator, definition H-13 
system time 
TIME keyword 

in display files 4-203 
in printer files 5-18 
system values 

(see QCURSYM; QDATFMT; QDATSEP; QDECFMT) 
general definition H-13 
Systems Network Architecture, definition 
of H-13 


tape drive 1 -8 
tape files 

DDS not valid for 1-1, 1-8 
definition H-13 
TEXT 

coding example 

for communications files or BSC 
files 6-25 

for display files 4-202 
for logical files 3-51 
for physical files 2-33 
for printer files 5-37 
keyword description 

for communications files or BSC 
files 6-25 

for display files 4-202 
for logical files 3-51 
for physical files 2-32 
for printer files 5-37 
text description (see TEXT; INDTXT; 
response indicators) 

TIME 

coding example 

for display files 4-203 
for printer files 5-38 
keyword description 

for display files 4-203 
for printer files 5-38 
trailing attribute byte (see ending 
attribute character) 
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transformation of data type 3-24 
transmission interruption 6-T5 
TRNRND 

coding example 6-26 
keyword description 6-26 
truncate, definition of H-13 
turnaround transmission 6-26 


UL (Underline) 4-83 
UNDERLINE 

coding example 5-38 
keyword description 5-38 
underline (see also CHGINPDFT; UNDERLINE) 
on printer output (UNDERLINE) 5-38 
to prevent on display screen 4-28 
to underline fields (DSPATR(UL)) 4-83 
UNIQUE 

(see also key field name; access path) 
coding example 

for logical files 3-52 
for physical files 2-34 
keyword description 
for logical files 3-52 
for physical files 2-34 
when to use 2-5 
UNLOCK 

coding example 4-205 
keyword description 4-204 
with GETRETAIN 4-114 
UP (Aid byte) 4-151 
update operation 
definition H-13 
how used in this manual 1 -2 
uppercase 

CHECK(LC) 4-59 
keybdard shift attribute 4-17 
Usage (position 38) 
general 

for communications files or BSC 
files 6-11 

for display files 4-28 
for logical files 3-26 
for physical files 2-11 
for printer files 5-9 
valid entries 

B (both) 4-28 

Blank or 0 (output-'^nly) 4-28 
H (hidden) 4-28 
I (input-only) 4-28 
M (message) 4-28 
user-blocked data 6-14, 6-17 
user-defined data stream 4-206 
user-defined edit codes 
definition H-13 


user-defined edit codes (continued) 
with EDTCDE 

for display files 4-100 
for printer files 5-20 
user profile, definition of H-13 
USRDFN 

(see also KEEP; OPENPRT; PASSRCD; PRINT; 
TEXT; 

routing keywords) 
coding example 4-206 
keyword description 4-206 


validity checker, definition of H-13 
validity checking 
CHECK 

for display files 4-53 
for logical files 3-34 
for physical files 2-17 
CMP (see COMP) 

COMP 

for display files 4-70 
for logical files 3-36 
for physical files 2-17 
definition H-13 
display example F-29 
RANGE 

for display files 4-143 
for logical files 3-48 
for physical files 2-27 
VALUES 

for display files 4-207 
for logical files 3-53 
for physical flies 2-35 
with CAnn key 4-44 
with DUP 4-96 
VALUES 

as select/omit level keyword 
for logical files 3-53 
as validity checking keyword 
for display files 4-207 
for logical files 3-53 
for physical files 2-35 
coding example 

for display files 4-207 
for logical files 3-53 
keyword description 

for display files 4-152 
for logical files 3-53 
variable clear line (see CLRL; SLNO) 
variable length records (subfile) F-37 
variable starting line number (see SLNO) 
variable, definition of H-13 
vertically displayed records, definition 
of H-13 
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VLDCMDKEY zoned decimal format definition of H-13 

coding example 4-208 zoned field, definition of H-13 

keyword description 4-208 
VN (validate name) 4-57 


W position 35 (see Keyboard Shift (position 
35)) 

work station device 1-8 
work station user, definition of H-13 
work station, definition of H-13 
write operation 1-2 


X in position 35 (see Keyboard Shift 
(position 35)) 


as edit code 

for display files 4-74, 4-99 
in position 35 (see Keyboard Shift 
(position 35)) 


zero 

in edit word 

for display files 4-104 
for logical files 3-43 
for physical files 2-23 
for printer files 5-23 
zero balance 

display of 4-104 
printing of 5-19 
zero suppression 
edited output chart 

for display files 4-104 
for printer files 5-19 

ZONE 

(see also ABSVAL; DIGIT; SIGNED) 
coding example 

for logical files 3-54 
for physical files 2-35 
keyword description 
for logical files 3-54 
for physical files 2-35 
zone portion 2-35, 3-54 
zoned decimal (see Data Type (position 35)) 
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